Linux Audio

Check our new training course

Loading...
v4.6
   1#define pr_fmt(fmt)  "irq: " fmt
   2
   3#include <linux/debugfs.h>
   4#include <linux/hardirq.h>
   5#include <linux/interrupt.h>
   6#include <linux/irq.h>
   7#include <linux/irqdesc.h>
   8#include <linux/irqdomain.h>
   9#include <linux/module.h>
  10#include <linux/mutex.h>
  11#include <linux/of.h>
  12#include <linux/of_address.h>
  13#include <linux/of_irq.h>
  14#include <linux/topology.h>
  15#include <linux/seq_file.h>
  16#include <linux/slab.h>
  17#include <linux/smp.h>
  18#include <linux/fs.h>
  19
 
 
 
 
 
 
  20static LIST_HEAD(irq_domain_list);
  21static DEFINE_MUTEX(irq_domain_mutex);
  22
  23static DEFINE_MUTEX(revmap_trees_mutex);
  24static struct irq_domain *irq_default_domain;
  25
  26static void irq_domain_check_hierarchy(struct irq_domain *domain);
  27
  28struct irqchip_fwid {
  29	struct fwnode_handle fwnode;
  30	char *name;
  31	void *data;
  32};
  33
  34/**
  35 * irq_domain_alloc_fwnode - Allocate a fwnode_handle suitable for
  36 *                           identifying an irq domain
  37 * @data: optional user-provided data
  38 *
  39 * Allocate a struct device_node, and return a poiner to the embedded
  40 * fwnode_handle (or NULL on failure).
  41 */
  42struct fwnode_handle *irq_domain_alloc_fwnode(void *data)
  43{
  44	struct irqchip_fwid *fwid;
  45	char *name;
  46
  47	fwid = kzalloc(sizeof(*fwid), GFP_KERNEL);
  48	name = kasprintf(GFP_KERNEL, "irqchip@%p", data);
  49
  50	if (!fwid || !name) {
  51		kfree(fwid);
  52		kfree(name);
  53		return NULL;
  54	}
  55
  56	fwid->name = name;
  57	fwid->data = data;
  58	fwid->fwnode.type = FWNODE_IRQCHIP;
  59	return &fwid->fwnode;
  60}
  61EXPORT_SYMBOL_GPL(irq_domain_alloc_fwnode);
  62
  63/**
  64 * irq_domain_free_fwnode - Free a non-OF-backed fwnode_handle
  65 *
  66 * Free a fwnode_handle allocated with irq_domain_alloc_fwnode.
  67 */
  68void irq_domain_free_fwnode(struct fwnode_handle *fwnode)
  69{
  70	struct irqchip_fwid *fwid;
  71
  72	if (WARN_ON(!is_fwnode_irqchip(fwnode)))
  73		return;
  74
  75	fwid = container_of(fwnode, struct irqchip_fwid, fwnode);
  76	kfree(fwid->name);
  77	kfree(fwid);
  78}
  79EXPORT_SYMBOL_GPL(irq_domain_free_fwnode);
  80
  81/**
  82 * __irq_domain_add() - Allocate a new irq_domain data structure
  83 * @of_node: optional device-tree node of the interrupt controller
  84 * @size: Size of linear map; 0 for radix mapping only
  85 * @hwirq_max: Maximum number of interrupts supported by controller
  86 * @direct_max: Maximum value of direct maps; Use ~0 for no limit; 0 for no
  87 *              direct mapping
  88 * @ops: domain callbacks
  89 * @host_data: Controller private data pointer
  90 *
  91 * Allocates and initialize and irq_domain structure.
  92 * Returns pointer to IRQ domain, or NULL on failure.
  93 */
  94struct irq_domain *__irq_domain_add(struct fwnode_handle *fwnode, int size,
  95				    irq_hw_number_t hwirq_max, int direct_max,
  96				    const struct irq_domain_ops *ops,
  97				    void *host_data)
 
  98{
  99	struct irq_domain *domain;
 100	struct device_node *of_node;
 101
 102	of_node = to_of_node(fwnode);
 103
 104	domain = kzalloc_node(sizeof(*domain) + (sizeof(unsigned int) * size),
 105			      GFP_KERNEL, of_node_to_nid(of_node));
 106	if (WARN_ON(!domain))
 107		return NULL;
 108
 109	of_node_get(of_node);
 110
 111	/* Fill structure */
 112	INIT_RADIX_TREE(&domain->revmap_tree, GFP_KERNEL);
 113	domain->ops = ops;
 114	domain->host_data = host_data;
 115	domain->fwnode = fwnode;
 116	domain->hwirq_max = hwirq_max;
 117	domain->revmap_size = size;
 118	domain->revmap_direct_max_irq = direct_max;
 119	irq_domain_check_hierarchy(domain);
 
 
 
 
 
 120
 
 
 121	mutex_lock(&irq_domain_mutex);
 122	list_add(&domain->link, &irq_domain_list);
 123	mutex_unlock(&irq_domain_mutex);
 124
 125	pr_debug("Added domain %s\n", domain->name);
 126	return domain;
 127}
 128EXPORT_SYMBOL_GPL(__irq_domain_add);
 129
 130/**
 131 * irq_domain_remove() - Remove an irq domain.
 132 * @domain: domain to remove
 133 *
 134 * This routine is used to remove an irq domain. The caller must ensure
 135 * that all mappings within the domain have been disposed of prior to
 136 * use, depending on the revmap type.
 137 */
 138void irq_domain_remove(struct irq_domain *domain)
 139{
 140	mutex_lock(&irq_domain_mutex);
 141
 142	/*
 143	 * radix_tree_delete() takes care of destroying the root
 144	 * node when all entries are removed. Shout if there are
 145	 * any mappings left.
 146	 */
 147	WARN_ON(domain->revmap_tree.height);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 148
 149	list_del(&domain->link);
 150
 151	/*
 152	 * If the going away domain is the default one, reset it.
 153	 */
 154	if (unlikely(irq_default_domain == domain))
 155		irq_set_default_host(NULL);
 156
 157	mutex_unlock(&irq_domain_mutex);
 158
 159	pr_debug("Removed domain %s\n", domain->name);
 
 160
 161	of_node_put(irq_domain_get_of_node(domain));
 162	kfree(domain);
 163}
 164EXPORT_SYMBOL_GPL(irq_domain_remove);
 165
 
 
 
 
 
 
 
 
 
 
 
 166/**
 167 * irq_domain_add_simple() - Register an irq_domain and optionally map a range of irqs
 168 * @of_node: pointer to interrupt controller's device tree node.
 169 * @size: total number of irqs in mapping
 170 * @first_irq: first number of irq block assigned to the domain,
 171 *	pass zero to assign irqs on-the-fly. If first_irq is non-zero, then
 172 *	pre-map all of the irqs in the domain to virqs starting at first_irq.
 173 * @ops: domain callbacks
 
 174 * @host_data: Controller private data pointer
 175 *
 176 * Allocates an irq_domain, and optionally if first_irq is positive then also
 177 * allocate irq_descs and map all of the hwirqs to virqs starting at first_irq.
 178 *
 179 * This is intended to implement the expected behaviour for most
 180 * interrupt controllers. If device tree is used, then first_irq will be 0 and
 181 * irqs get mapped dynamically on the fly. However, if the controller requires
 182 * static virq assignments (non-DT boot) then it will set that up correctly.
 183 */
 184struct irq_domain *irq_domain_add_simple(struct device_node *of_node,
 185					 unsigned int size,
 186					 unsigned int first_irq,
 
 187					 const struct irq_domain_ops *ops,
 188					 void *host_data)
 189{
 190	struct irq_domain *domain;
 
 191
 192	domain = __irq_domain_add(of_node_to_fwnode(of_node), size, size, 0, ops, host_data);
 193	if (!domain)
 194		return NULL;
 195
 196	if (first_irq > 0) {
 197		if (IS_ENABLED(CONFIG_SPARSE_IRQ)) {
 198			/* attempt to allocated irq_descs */
 199			int rc = irq_alloc_descs(first_irq, first_irq, size,
 200						 of_node_to_nid(of_node));
 201			if (rc < 0)
 202				pr_info("Cannot allocate irq_descs @ IRQ%d, assuming pre-allocated\n",
 203					first_irq);
 
 
 
 
 
 
 204		}
 205		irq_domain_associate_many(domain, first_irq, 0, size);
 206	}
 207
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 208	return domain;
 209}
 210EXPORT_SYMBOL_GPL(irq_domain_add_simple);
 211
 212/**
 213 * irq_domain_add_legacy() - Allocate and register a legacy revmap irq_domain.
 214 * @of_node: pointer to interrupt controller's device tree node.
 215 * @size: total number of irqs in legacy mapping
 216 * @first_irq: first number of irq block assigned to the domain
 217 * @first_hwirq: first hwirq number to use for the translation. Should normally
 218 *               be '0', but a positive integer can be used if the effective
 219 *               hwirqs numbering does not begin at zero.
 220 * @ops: map/unmap domain callbacks
 221 * @host_data: Controller private data pointer
 222 *
 223 * Note: the map() callback will be called before this function returns
 224 * for all legacy interrupts except 0 (which is always the invalid irq for
 225 * a legacy controller).
 226 */
 227struct irq_domain *irq_domain_add_legacy(struct device_node *of_node,
 228					 unsigned int size,
 229					 unsigned int first_irq,
 230					 irq_hw_number_t first_hwirq,
 231					 const struct irq_domain_ops *ops,
 232					 void *host_data)
 233{
 234	struct irq_domain *domain;
 
 235
 236	domain = __irq_domain_add(of_node_to_fwnode(of_node), first_hwirq + size,
 237				  first_hwirq + size, 0, ops, host_data);
 238	if (domain)
 239		irq_domain_associate_many(domain, first_irq, first_hwirq, size);
 240
 
 
 
 
 
 
 
 
 241	return domain;
 242}
 243EXPORT_SYMBOL_GPL(irq_domain_add_legacy);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 244
 245/**
 246 * irq_find_matching_fwnode() - Locates a domain for a given fwnode
 247 * @fwnode: FW descriptor of the interrupt controller
 248 * @bus_token: domain-specific data
 
 
 
 249 */
 250struct irq_domain *irq_find_matching_fwnode(struct fwnode_handle *fwnode,
 251					    enum irq_domain_bus_token bus_token)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 252{
 253	struct irq_domain *h, *found = NULL;
 254	int rc;
 255
 256	/* We might want to match the legacy controller last since
 257	 * it might potentially be set to match all interrupts in
 258	 * the absence of a device node. This isn't a problem so far
 259	 * yet though...
 260	 *
 261	 * bus_token == DOMAIN_BUS_ANY matches any domain, any other
 262	 * values must generate an exact match for the domain to be
 263	 * selected.
 264	 */
 265	mutex_lock(&irq_domain_mutex);
 266	list_for_each_entry(h, &irq_domain_list, link) {
 267		if (h->ops->match)
 268			rc = h->ops->match(h, to_of_node(fwnode), bus_token);
 269		else
 270			rc = ((fwnode != NULL) && (h->fwnode == fwnode) &&
 271			      ((bus_token == DOMAIN_BUS_ANY) ||
 272			       (h->bus_token == bus_token)));
 273
 274		if (rc) {
 275			found = h;
 276			break;
 277		}
 278	}
 279	mutex_unlock(&irq_domain_mutex);
 280	return found;
 281}
 282EXPORT_SYMBOL_GPL(irq_find_matching_fwnode);
 283
 284/**
 285 * irq_set_default_host() - Set a "default" irq domain
 286 * @domain: default domain pointer
 287 *
 288 * For convenience, it's possible to set a "default" domain that will be used
 289 * whenever NULL is passed to irq_create_mapping(). It makes life easier for
 290 * platforms that want to manipulate a few hard coded interrupt numbers that
 291 * aren't properly represented in the device-tree.
 292 */
 293void irq_set_default_host(struct irq_domain *domain)
 294{
 295	pr_debug("Default domain set to @0x%p\n", domain);
 296
 297	irq_default_domain = domain;
 298}
 299EXPORT_SYMBOL_GPL(irq_set_default_host);
 300
 301void irq_domain_disassociate(struct irq_domain *domain, unsigned int irq)
 302{
 303	struct irq_data *irq_data = irq_get_irq_data(irq);
 304	irq_hw_number_t hwirq;
 305
 306	if (WARN(!irq_data || irq_data->domain != domain,
 307		 "virq%i doesn't exist; cannot disassociate\n", irq))
 308		return;
 309
 310	hwirq = irq_data->hwirq;
 311	irq_set_status_flags(irq, IRQ_NOREQUEST);
 312
 313	/* remove chip and handler */
 314	irq_set_chip_and_handler(irq, NULL, NULL);
 315
 316	/* Make sure it's completed */
 317	synchronize_irq(irq);
 318
 319	/* Tell the PIC about it */
 320	if (domain->ops->unmap)
 321		domain->ops->unmap(domain, irq);
 322	smp_mb();
 323
 324	irq_data->domain = NULL;
 325	irq_data->hwirq = 0;
 326
 327	/* Clear reverse map for this hwirq */
 328	if (hwirq < domain->revmap_size) {
 329		domain->linear_revmap[hwirq] = 0;
 330	} else {
 331		mutex_lock(&revmap_trees_mutex);
 332		radix_tree_delete(&domain->revmap_tree, hwirq);
 333		mutex_unlock(&revmap_trees_mutex);
 334	}
 335}
 336
 337int irq_domain_associate(struct irq_domain *domain, unsigned int virq,
 338			 irq_hw_number_t hwirq)
 339{
 340	struct irq_data *irq_data = irq_get_irq_data(virq);
 341	int ret;
 342
 343	if (WARN(hwirq >= domain->hwirq_max,
 344		 "error: hwirq 0x%x is too large for %s\n", (int)hwirq, domain->name))
 345		return -EINVAL;
 346	if (WARN(!irq_data, "error: virq%i is not allocated", virq))
 347		return -EINVAL;
 348	if (WARN(irq_data->domain, "error: virq%i is already associated", virq))
 349		return -EINVAL;
 350
 351	mutex_lock(&irq_domain_mutex);
 352	irq_data->hwirq = hwirq;
 353	irq_data->domain = domain;
 354	if (domain->ops->map) {
 355		ret = domain->ops->map(domain, virq, hwirq);
 356		if (ret != 0) {
 357			/*
 358			 * If map() returns -EPERM, this interrupt is protected
 359			 * by the firmware or some other service and shall not
 360			 * be mapped. Don't bother telling the user about it.
 361			 */
 362			if (ret != -EPERM) {
 363				pr_info("%s didn't like hwirq-0x%lx to VIRQ%i mapping (rc=%d)\n",
 364				       domain->name, hwirq, virq, ret);
 365			}
 366			irq_data->domain = NULL;
 367			irq_data->hwirq = 0;
 368			mutex_unlock(&irq_domain_mutex);
 369			return ret;
 370		}
 371
 372		/* If not already assigned, give the domain the chip's name */
 373		if (!domain->name && irq_data->chip)
 374			domain->name = irq_data->chip->name;
 375	}
 376
 377	if (hwirq < domain->revmap_size) {
 378		domain->linear_revmap[hwirq] = virq;
 379	} else {
 380		mutex_lock(&revmap_trees_mutex);
 381		radix_tree_insert(&domain->revmap_tree, hwirq, irq_data);
 382		mutex_unlock(&revmap_trees_mutex);
 383	}
 384	mutex_unlock(&irq_domain_mutex);
 385
 386	irq_clear_status_flags(virq, IRQ_NOREQUEST);
 387
 388	return 0;
 389}
 390EXPORT_SYMBOL_GPL(irq_domain_associate);
 391
 392void irq_domain_associate_many(struct irq_domain *domain, unsigned int irq_base,
 393			       irq_hw_number_t hwirq_base, int count)
 394{
 395	struct device_node *of_node;
 396	int i;
 397
 398	of_node = irq_domain_get_of_node(domain);
 399	pr_debug("%s(%s, irqbase=%i, hwbase=%i, count=%i)\n", __func__,
 400		of_node_full_name(of_node), irq_base, (int)hwirq_base, count);
 401
 402	for (i = 0; i < count; i++) {
 403		irq_domain_associate(domain, irq_base + i, hwirq_base + i);
 404	}
 405}
 406EXPORT_SYMBOL_GPL(irq_domain_associate_many);
 407
 408/**
 409 * irq_create_direct_mapping() - Allocate an irq for direct mapping
 410 * @domain: domain to allocate the irq for or NULL for default domain
 411 *
 412 * This routine is used for irq controllers which can choose the hardware
 413 * interrupt numbers they generate. In such a case it's simplest to use
 414 * the linux irq as the hardware interrupt number. It still uses the linear
 415 * or radix tree to store the mapping, but the irq controller can optimize
 416 * the revmap path by using the hwirq directly.
 417 */
 418unsigned int irq_create_direct_mapping(struct irq_domain *domain)
 419{
 420	struct device_node *of_node;
 421	unsigned int virq;
 422
 423	if (domain == NULL)
 424		domain = irq_default_domain;
 425
 426	of_node = irq_domain_get_of_node(domain);
 427	virq = irq_alloc_desc_from(1, of_node_to_nid(of_node));
 
 
 428	if (!virq) {
 429		pr_debug("create_direct virq allocation failed\n");
 430		return 0;
 431	}
 432	if (virq >= domain->revmap_direct_max_irq) {
 433		pr_err("ERROR: no free irqs available below %i maximum\n",
 434			domain->revmap_direct_max_irq);
 435		irq_free_desc(virq);
 436		return 0;
 437	}
 438	pr_debug("create_direct obtained virq %d\n", virq);
 439
 440	if (irq_domain_associate(domain, virq, virq)) {
 441		irq_free_desc(virq);
 442		return 0;
 443	}
 444
 445	return virq;
 446}
 447EXPORT_SYMBOL_GPL(irq_create_direct_mapping);
 448
 449/**
 450 * irq_create_mapping() - Map a hardware interrupt into linux irq space
 451 * @domain: domain owning this hardware interrupt or NULL for default domain
 452 * @hwirq: hardware irq number in that domain space
 453 *
 454 * Only one mapping per hardware interrupt is permitted. Returns a linux
 455 * irq number.
 456 * If the sense/trigger is to be specified, set_irq_type() should be called
 457 * on the number returned from that call.
 458 */
 459unsigned int irq_create_mapping(struct irq_domain *domain,
 460				irq_hw_number_t hwirq)
 461{
 462	struct device_node *of_node;
 463	int virq;
 464
 465	pr_debug("irq_create_mapping(0x%p, 0x%lx)\n", domain, hwirq);
 466
 467	/* Look for default domain if nececssary */
 468	if (domain == NULL)
 469		domain = irq_default_domain;
 470	if (domain == NULL) {
 471		WARN(1, "%s(, %lx) called with NULL domain\n", __func__, hwirq);
 
 
 472		return 0;
 473	}
 474	pr_debug("-> using domain @%p\n", domain);
 475
 476	of_node = irq_domain_get_of_node(domain);
 477
 478	/* Check if mapping already exists */
 479	virq = irq_find_mapping(domain, hwirq);
 480	if (virq) {
 481		pr_debug("-> existing mapping on virq %d\n", virq);
 482		return virq;
 483	}
 484
 
 
 
 
 485	/* Allocate a virtual interrupt number */
 486	virq = irq_domain_alloc_descs(-1, 1, hwirq, of_node_to_nid(of_node));
 
 
 
 
 
 487	if (virq <= 0) {
 488		pr_debug("-> virq allocation failed\n");
 489		return 0;
 490	}
 491
 492	if (irq_domain_associate(domain, virq, hwirq)) {
 493		irq_free_desc(virq);
 
 494		return 0;
 495	}
 496
 497	pr_debug("irq %lu on domain %s mapped to virtual irq %u\n",
 498		hwirq, of_node_full_name(of_node), virq);
 499
 500	return virq;
 501}
 502EXPORT_SYMBOL_GPL(irq_create_mapping);
 503
 504/**
 505 * irq_create_strict_mappings() - Map a range of hw irqs to fixed linux irqs
 506 * @domain: domain owning the interrupt range
 507 * @irq_base: beginning of linux IRQ range
 508 * @hwirq_base: beginning of hardware IRQ range
 509 * @count: Number of interrupts to map
 510 *
 511 * This routine is used for allocating and mapping a range of hardware
 512 * irqs to linux irqs where the linux irq numbers are at pre-defined
 513 * locations. For use by controllers that already have static mappings
 514 * to insert in to the domain.
 515 *
 516 * Non-linear users can use irq_create_identity_mapping() for IRQ-at-a-time
 517 * domain insertion.
 518 *
 519 * 0 is returned upon success, while any failure to establish a static
 520 * mapping is treated as an error.
 521 */
 522int irq_create_strict_mappings(struct irq_domain *domain, unsigned int irq_base,
 523			       irq_hw_number_t hwirq_base, int count)
 524{
 525	struct device_node *of_node;
 526	int ret;
 527
 528	of_node = irq_domain_get_of_node(domain);
 529	ret = irq_alloc_descs(irq_base, irq_base, count,
 530			      of_node_to_nid(of_node));
 531	if (unlikely(ret < 0))
 532		return ret;
 533
 534	irq_domain_associate_many(domain, irq_base, hwirq_base, count);
 535	return 0;
 536}
 537EXPORT_SYMBOL_GPL(irq_create_strict_mappings);
 538
 539static int irq_domain_translate(struct irq_domain *d,
 540				struct irq_fwspec *fwspec,
 541				irq_hw_number_t *hwirq, unsigned int *type)
 542{
 543#ifdef CONFIG_IRQ_DOMAIN_HIERARCHY
 544	if (d->ops->translate)
 545		return d->ops->translate(d, fwspec, hwirq, type);
 546#endif
 547	if (d->ops->xlate)
 548		return d->ops->xlate(d, to_of_node(fwspec->fwnode),
 549				     fwspec->param, fwspec->param_count,
 550				     hwirq, type);
 551
 552	/* If domain has no translation, then we assume interrupt line */
 553	*hwirq = fwspec->param[0];
 554	return 0;
 555}
 556
 557static void of_phandle_args_to_fwspec(struct of_phandle_args *irq_data,
 558				      struct irq_fwspec *fwspec)
 559{
 560	int i;
 561
 562	fwspec->fwnode = irq_data->np ? &irq_data->np->fwnode : NULL;
 563	fwspec->param_count = irq_data->args_count;
 564
 565	for (i = 0; i < irq_data->args_count; i++)
 566		fwspec->param[i] = irq_data->args[i];
 567}
 568
 569unsigned int irq_create_fwspec_mapping(struct irq_fwspec *fwspec)
 570{
 571	struct irq_domain *domain;
 572	irq_hw_number_t hwirq;
 573	unsigned int type = IRQ_TYPE_NONE;
 574	int virq;
 575
 576	if (fwspec->fwnode) {
 577		domain = irq_find_matching_fwnode(fwspec->fwnode,
 578						  DOMAIN_BUS_WIRED);
 579		if (!domain)
 580			domain = irq_find_matching_fwnode(fwspec->fwnode,
 581							  DOMAIN_BUS_ANY);
 582	} else {
 583		domain = irq_default_domain;
 584	}
 585
 
 586	if (!domain) {
 587		pr_warn("no irq domain found for %s !\n",
 588			of_node_full_name(to_of_node(fwspec->fwnode)));
 589		return 0;
 590	}
 591
 592	if (irq_domain_translate(domain, fwspec, &hwirq, &type))
 593		return 0;
 594
 595	if (irq_domain_is_hierarchy(domain)) {
 596		/*
 597		 * If we've already configured this interrupt,
 598		 * don't do it again, or hell will break loose.
 
 
 
 
 599		 */
 600		virq = irq_find_mapping(domain, hwirq);
 601		if (virq)
 602			return virq;
 
 
 
 
 603
 604		virq = irq_domain_alloc_irqs(domain, 1, NUMA_NO_NODE, fwspec);
 605		if (virq <= 0)
 
 
 
 
 606			return 0;
 607	} else {
 608		/* Create mapping */
 609		virq = irq_create_mapping(domain, hwirq);
 610		if (!virq)
 611			return virq;
 612	}
 613
 
 
 
 
 
 614	/* Set type if specified and different than the current one */
 615	if (type != IRQ_TYPE_NONE &&
 616	    type != irq_get_trigger_type(virq))
 617		irq_set_irq_type(virq, type);
 618	return virq;
 619}
 620EXPORT_SYMBOL_GPL(irq_create_fwspec_mapping);
 621
 622unsigned int irq_create_of_mapping(struct of_phandle_args *irq_data)
 623{
 624	struct irq_fwspec fwspec;
 625
 626	of_phandle_args_to_fwspec(irq_data, &fwspec);
 627	return irq_create_fwspec_mapping(&fwspec);
 628}
 629EXPORT_SYMBOL_GPL(irq_create_of_mapping);
 630
 631/**
 632 * irq_dispose_mapping() - Unmap an interrupt
 633 * @virq: linux irq number of the interrupt to unmap
 634 */
 635void irq_dispose_mapping(unsigned int virq)
 636{
 637	struct irq_data *irq_data = irq_get_irq_data(virq);
 638	struct irq_domain *domain;
 
 639
 640	if (!virq || !irq_data)
 641		return;
 642
 643	domain = irq_data->domain;
 644	if (WARN_ON(domain == NULL))
 645		return;
 646
 647	irq_domain_disassociate(domain, virq);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 648	irq_free_desc(virq);
 649}
 650EXPORT_SYMBOL_GPL(irq_dispose_mapping);
 651
 652/**
 653 * irq_find_mapping() - Find a linux irq from an hw irq number.
 654 * @domain: domain owning this hardware interrupt
 655 * @hwirq: hardware irq number in that domain space
 
 
 
 
 656 */
 657unsigned int irq_find_mapping(struct irq_domain *domain,
 658			      irq_hw_number_t hwirq)
 659{
 660	struct irq_data *data;
 
 661
 662	/* Look for default domain if nececssary */
 663	if (domain == NULL)
 664		domain = irq_default_domain;
 665	if (domain == NULL)
 666		return 0;
 667
 668	if (hwirq < domain->revmap_direct_max_irq) {
 669		data = irq_domain_get_irq_data(domain, hwirq);
 670		if (data && data->hwirq == hwirq)
 671			return hwirq;
 672	}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 673
 674	/* Check if the hwirq is in the linear revmap. */
 675	if (hwirq < domain->revmap_size)
 676		return domain->linear_revmap[hwirq];
 
 
 
 
 
 
 
 
 
 
 
 
 677
 
 
 
 
 678	rcu_read_lock();
 679	data = radix_tree_lookup(&domain->revmap_tree, hwirq);
 680	rcu_read_unlock();
 681	return data ? data->irq : 0;
 
 
 
 
 
 
 682}
 683EXPORT_SYMBOL_GPL(irq_find_mapping);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 684
 685#ifdef CONFIG_IRQ_DOMAIN_DEBUG
 686static int virq_debug_show(struct seq_file *m, void *private)
 687{
 688	unsigned long flags;
 689	struct irq_desc *desc;
 690	struct irq_domain *domain;
 691	struct radix_tree_iter iter;
 692	void *data, **slot;
 693	int i;
 694
 695	seq_printf(m, " %-16s  %-6s  %-10s  %-10s  %s\n",
 696		   "name", "mapped", "linear-max", "direct-max", "devtree-node");
 697	mutex_lock(&irq_domain_mutex);
 698	list_for_each_entry(domain, &irq_domain_list, link) {
 699		struct device_node *of_node;
 700		int count = 0;
 701		of_node = irq_domain_get_of_node(domain);
 702		radix_tree_for_each_slot(slot, &domain->revmap_tree, &iter, 0)
 703			count++;
 704		seq_printf(m, "%c%-16s  %6u  %10u  %10u  %s\n",
 705			   domain == irq_default_domain ? '*' : ' ', domain->name,
 706			   domain->revmap_size + count, domain->revmap_size,
 707			   domain->revmap_direct_max_irq,
 708			   of_node ? of_node_full_name(of_node) : "");
 709	}
 710	mutex_unlock(&irq_domain_mutex);
 711
 712	seq_printf(m, "%-5s  %-7s  %-15s  %-*s  %6s  %-14s  %s\n", "irq", "hwirq",
 713		      "chip name", (int)(2 * sizeof(void *) + 2), "chip data",
 714		      "active", "type", "domain");
 715
 716	for (i = 1; i < nr_irqs; i++) {
 717		desc = irq_to_desc(i);
 718		if (!desc)
 719			continue;
 720
 721		raw_spin_lock_irqsave(&desc->lock, flags);
 722		domain = desc->irq_data.domain;
 723
 724		if (domain) {
 725			struct irq_chip *chip;
 726			int hwirq = desc->irq_data.hwirq;
 727			bool direct;
 728
 729			seq_printf(m, "%5d  ", i);
 730			seq_printf(m, "0x%05x  ", hwirq);
 731
 732			chip = irq_desc_get_chip(desc);
 733			seq_printf(m, "%-15s  ", (chip && chip->name) ? chip->name : "none");
 
 
 
 
 734
 735			data = irq_desc_get_chip_data(desc);
 736			seq_printf(m, data ? "0x%p  " : "  %p  ", data);
 737
 738			seq_printf(m, "   %c    ", (desc->action && desc->action->handler) ? '*' : ' ');
 739			direct = (i == hwirq) && (i < domain->revmap_direct_max_irq);
 740			seq_printf(m, "%6s%-8s  ",
 741				   (hwirq < domain->revmap_size) ? "LINEAR" : "RADIX",
 742				   direct ? "(DIRECT)" : "");
 743			seq_printf(m, "%s\n", desc->irq_data.domain->name);
 744		}
 745
 746		raw_spin_unlock_irqrestore(&desc->lock, flags);
 747	}
 748
 749	return 0;
 750}
 751
 752static int virq_debug_open(struct inode *inode, struct file *file)
 753{
 754	return single_open(file, virq_debug_show, inode->i_private);
 755}
 756
 757static const struct file_operations virq_debug_fops = {
 758	.open = virq_debug_open,
 759	.read = seq_read,
 760	.llseek = seq_lseek,
 761	.release = single_release,
 762};
 763
 764static int __init irq_debugfs_init(void)
 765{
 766	if (debugfs_create_file("irq_domain_mapping", S_IRUGO, NULL,
 767				 NULL, &virq_debug_fops) == NULL)
 768		return -ENOMEM;
 769
 770	return 0;
 771}
 772__initcall(irq_debugfs_init);
 773#endif /* CONFIG_IRQ_DOMAIN_DEBUG */
 774
 
 
 
 
 
 
 775/**
 776 * irq_domain_xlate_onecell() - Generic xlate for direct one cell bindings
 777 *
 778 * Device Tree IRQ specifier translation function which works with one cell
 779 * bindings where the cell value maps directly to the hwirq number.
 780 */
 781int irq_domain_xlate_onecell(struct irq_domain *d, struct device_node *ctrlr,
 782			     const u32 *intspec, unsigned int intsize,
 783			     unsigned long *out_hwirq, unsigned int *out_type)
 784{
 785	if (WARN_ON(intsize < 1))
 786		return -EINVAL;
 787	*out_hwirq = intspec[0];
 788	*out_type = IRQ_TYPE_NONE;
 789	return 0;
 790}
 791EXPORT_SYMBOL_GPL(irq_domain_xlate_onecell);
 792
 793/**
 794 * irq_domain_xlate_twocell() - Generic xlate for direct two cell bindings
 795 *
 796 * Device Tree IRQ specifier translation function which works with two cell
 797 * bindings where the cell values map directly to the hwirq number
 798 * and linux irq flags.
 799 */
 800int irq_domain_xlate_twocell(struct irq_domain *d, struct device_node *ctrlr,
 801			const u32 *intspec, unsigned int intsize,
 802			irq_hw_number_t *out_hwirq, unsigned int *out_type)
 803{
 804	if (WARN_ON(intsize < 2))
 805		return -EINVAL;
 806	*out_hwirq = intspec[0];
 807	*out_type = intspec[1] & IRQ_TYPE_SENSE_MASK;
 808	return 0;
 809}
 810EXPORT_SYMBOL_GPL(irq_domain_xlate_twocell);
 811
 812/**
 813 * irq_domain_xlate_onetwocell() - Generic xlate for one or two cell bindings
 814 *
 815 * Device Tree IRQ specifier translation function which works with either one
 816 * or two cell bindings where the cell values map directly to the hwirq number
 817 * and linux irq flags.
 818 *
 819 * Note: don't use this function unless your interrupt controller explicitly
 820 * supports both one and two cell bindings.  For the majority of controllers
 821 * the _onecell() or _twocell() variants above should be used.
 822 */
 823int irq_domain_xlate_onetwocell(struct irq_domain *d,
 824				struct device_node *ctrlr,
 825				const u32 *intspec, unsigned int intsize,
 826				unsigned long *out_hwirq, unsigned int *out_type)
 827{
 828	if (WARN_ON(intsize < 1))
 829		return -EINVAL;
 830	*out_hwirq = intspec[0];
 831	*out_type = (intsize > 1) ? intspec[1] : IRQ_TYPE_NONE;
 832	return 0;
 833}
 834EXPORT_SYMBOL_GPL(irq_domain_xlate_onetwocell);
 835
 836const struct irq_domain_ops irq_domain_simple_ops = {
 
 837	.xlate = irq_domain_xlate_onetwocell,
 838};
 839EXPORT_SYMBOL_GPL(irq_domain_simple_ops);
 840
 841int irq_domain_alloc_descs(int virq, unsigned int cnt, irq_hw_number_t hwirq,
 842			   int node)
 843{
 844	unsigned int hint;
 845
 846	if (virq >= 0) {
 847		virq = irq_alloc_descs(virq, virq, cnt, node);
 848	} else {
 849		hint = hwirq % nr_irqs;
 850		if (hint == 0)
 851			hint++;
 852		virq = irq_alloc_descs_from(hint, cnt, node);
 853		if (virq <= 0 && hint > 1)
 854			virq = irq_alloc_descs_from(1, cnt, node);
 855	}
 856
 857	return virq;
 858}
 859
 860#ifdef	CONFIG_IRQ_DOMAIN_HIERARCHY
 861/**
 862 * irq_domain_create_hierarchy - Add a irqdomain into the hierarchy
 863 * @parent:	Parent irq domain to associate with the new domain
 864 * @flags:	Irq domain flags associated to the domain
 865 * @size:	Size of the domain. See below
 866 * @fwnode:	Optional fwnode of the interrupt controller
 867 * @ops:	Pointer to the interrupt domain callbacks
 868 * @host_data:	Controller private data pointer
 869 *
 870 * If @size is 0 a tree domain is created, otherwise a linear domain.
 871 *
 872 * If successful the parent is associated to the new domain and the
 873 * domain flags are set.
 874 * Returns pointer to IRQ domain, or NULL on failure.
 875 */
 876struct irq_domain *irq_domain_create_hierarchy(struct irq_domain *parent,
 877					    unsigned int flags,
 878					    unsigned int size,
 879					    struct fwnode_handle *fwnode,
 880					    const struct irq_domain_ops *ops,
 881					    void *host_data)
 882{
 883	struct irq_domain *domain;
 884
 885	if (size)
 886		domain = irq_domain_create_linear(fwnode, size, ops, host_data);
 887	else
 888		domain = irq_domain_create_tree(fwnode, ops, host_data);
 889	if (domain) {
 890		domain->parent = parent;
 891		domain->flags |= flags;
 892	}
 893
 894	return domain;
 895}
 896EXPORT_SYMBOL_GPL(irq_domain_create_hierarchy);
 897
 898static void irq_domain_insert_irq(int virq)
 899{
 900	struct irq_data *data;
 901
 902	for (data = irq_get_irq_data(virq); data; data = data->parent_data) {
 903		struct irq_domain *domain = data->domain;
 904		irq_hw_number_t hwirq = data->hwirq;
 905
 906		if (hwirq < domain->revmap_size) {
 907			domain->linear_revmap[hwirq] = virq;
 908		} else {
 909			mutex_lock(&revmap_trees_mutex);
 910			radix_tree_insert(&domain->revmap_tree, hwirq, data);
 911			mutex_unlock(&revmap_trees_mutex);
 912		}
 913
 914		/* If not already assigned, give the domain the chip's name */
 915		if (!domain->name && data->chip)
 916			domain->name = data->chip->name;
 917	}
 918
 919	irq_clear_status_flags(virq, IRQ_NOREQUEST);
 920}
 921
 922static void irq_domain_remove_irq(int virq)
 923{
 924	struct irq_data *data;
 925
 926	irq_set_status_flags(virq, IRQ_NOREQUEST);
 927	irq_set_chip_and_handler(virq, NULL, NULL);
 928	synchronize_irq(virq);
 929	smp_mb();
 930
 931	for (data = irq_get_irq_data(virq); data; data = data->parent_data) {
 932		struct irq_domain *domain = data->domain;
 933		irq_hw_number_t hwirq = data->hwirq;
 934
 935		if (hwirq < domain->revmap_size) {
 936			domain->linear_revmap[hwirq] = 0;
 937		} else {
 938			mutex_lock(&revmap_trees_mutex);
 939			radix_tree_delete(&domain->revmap_tree, hwirq);
 940			mutex_unlock(&revmap_trees_mutex);
 941		}
 942	}
 943}
 944
 945static struct irq_data *irq_domain_insert_irq_data(struct irq_domain *domain,
 946						   struct irq_data *child)
 947{
 948	struct irq_data *irq_data;
 949
 950	irq_data = kzalloc_node(sizeof(*irq_data), GFP_KERNEL,
 951				irq_data_get_node(child));
 952	if (irq_data) {
 953		child->parent_data = irq_data;
 954		irq_data->irq = child->irq;
 955		irq_data->common = child->common;
 956		irq_data->domain = domain;
 957	}
 958
 959	return irq_data;
 960}
 961
 962static void irq_domain_free_irq_data(unsigned int virq, unsigned int nr_irqs)
 963{
 964	struct irq_data *irq_data, *tmp;
 965	int i;
 966
 967	for (i = 0; i < nr_irqs; i++) {
 968		irq_data = irq_get_irq_data(virq + i);
 969		tmp = irq_data->parent_data;
 970		irq_data->parent_data = NULL;
 971		irq_data->domain = NULL;
 972
 973		while (tmp) {
 974			irq_data = tmp;
 975			tmp = tmp->parent_data;
 976			kfree(irq_data);
 977		}
 978	}
 979}
 980
 981static int irq_domain_alloc_irq_data(struct irq_domain *domain,
 982				     unsigned int virq, unsigned int nr_irqs)
 983{
 984	struct irq_data *irq_data;
 985	struct irq_domain *parent;
 986	int i;
 987
 988	/* The outermost irq_data is embedded in struct irq_desc */
 989	for (i = 0; i < nr_irqs; i++) {
 990		irq_data = irq_get_irq_data(virq + i);
 991		irq_data->domain = domain;
 992
 993		for (parent = domain->parent; parent; parent = parent->parent) {
 994			irq_data = irq_domain_insert_irq_data(parent, irq_data);
 995			if (!irq_data) {
 996				irq_domain_free_irq_data(virq, i + 1);
 997				return -ENOMEM;
 998			}
 999		}
1000	}
1001
1002	return 0;
1003}
1004
1005/**
1006 * irq_domain_get_irq_data - Get irq_data associated with @virq and @domain
1007 * @domain:	domain to match
1008 * @virq:	IRQ number to get irq_data
1009 */
1010struct irq_data *irq_domain_get_irq_data(struct irq_domain *domain,
1011					 unsigned int virq)
1012{
1013	struct irq_data *irq_data;
1014
1015	for (irq_data = irq_get_irq_data(virq); irq_data;
1016	     irq_data = irq_data->parent_data)
1017		if (irq_data->domain == domain)
1018			return irq_data;
1019
1020	return NULL;
1021}
1022EXPORT_SYMBOL_GPL(irq_domain_get_irq_data);
1023
1024/**
1025 * irq_domain_set_hwirq_and_chip - Set hwirq and irqchip of @virq at @domain
1026 * @domain:	Interrupt domain to match
1027 * @virq:	IRQ number
1028 * @hwirq:	The hwirq number
1029 * @chip:	The associated interrupt chip
1030 * @chip_data:	The associated chip data
1031 */
1032int irq_domain_set_hwirq_and_chip(struct irq_domain *domain, unsigned int virq,
1033				  irq_hw_number_t hwirq, struct irq_chip *chip,
1034				  void *chip_data)
1035{
1036	struct irq_data *irq_data = irq_domain_get_irq_data(domain, virq);
1037
1038	if (!irq_data)
1039		return -ENOENT;
1040
1041	irq_data->hwirq = hwirq;
1042	irq_data->chip = chip ? chip : &no_irq_chip;
1043	irq_data->chip_data = chip_data;
1044
1045	return 0;
1046}
1047EXPORT_SYMBOL_GPL(irq_domain_set_hwirq_and_chip);
1048
1049/**
1050 * irq_domain_set_info - Set the complete data for a @virq in @domain
1051 * @domain:		Interrupt domain to match
1052 * @virq:		IRQ number
1053 * @hwirq:		The hardware interrupt number
1054 * @chip:		The associated interrupt chip
1055 * @chip_data:		The associated interrupt chip data
1056 * @handler:		The interrupt flow handler
1057 * @handler_data:	The interrupt flow handler data
1058 * @handler_name:	The interrupt handler name
1059 */
1060void irq_domain_set_info(struct irq_domain *domain, unsigned int virq,
1061			 irq_hw_number_t hwirq, struct irq_chip *chip,
1062			 void *chip_data, irq_flow_handler_t handler,
1063			 void *handler_data, const char *handler_name)
1064{
1065	irq_domain_set_hwirq_and_chip(domain, virq, hwirq, chip, chip_data);
1066	__irq_set_handler(virq, handler, 0, handler_name);
1067	irq_set_handler_data(virq, handler_data);
1068}
1069EXPORT_SYMBOL(irq_domain_set_info);
1070
1071/**
1072 * irq_domain_reset_irq_data - Clear hwirq, chip and chip_data in @irq_data
1073 * @irq_data:	The pointer to irq_data
1074 */
1075void irq_domain_reset_irq_data(struct irq_data *irq_data)
1076{
1077	irq_data->hwirq = 0;
1078	irq_data->chip = &no_irq_chip;
1079	irq_data->chip_data = NULL;
1080}
1081EXPORT_SYMBOL_GPL(irq_domain_reset_irq_data);
1082
1083/**
1084 * irq_domain_free_irqs_common - Clear irq_data and free the parent
1085 * @domain:	Interrupt domain to match
1086 * @virq:	IRQ number to start with
1087 * @nr_irqs:	The number of irqs to free
1088 */
1089void irq_domain_free_irqs_common(struct irq_domain *domain, unsigned int virq,
1090				 unsigned int nr_irqs)
1091{
1092	struct irq_data *irq_data;
1093	int i;
1094
1095	for (i = 0; i < nr_irqs; i++) {
1096		irq_data = irq_domain_get_irq_data(domain, virq + i);
1097		if (irq_data)
1098			irq_domain_reset_irq_data(irq_data);
1099	}
1100	irq_domain_free_irqs_parent(domain, virq, nr_irqs);
1101}
1102
1103/**
1104 * irq_domain_free_irqs_top - Clear handler and handler data, clear irqdata and free parent
1105 * @domain:	Interrupt domain to match
1106 * @virq:	IRQ number to start with
1107 * @nr_irqs:	The number of irqs to free
1108 */
1109void irq_domain_free_irqs_top(struct irq_domain *domain, unsigned int virq,
1110			      unsigned int nr_irqs)
1111{
1112	int i;
1113
1114	for (i = 0; i < nr_irqs; i++) {
1115		irq_set_handler_data(virq + i, NULL);
1116		irq_set_handler(virq + i, NULL);
1117	}
1118	irq_domain_free_irqs_common(domain, virq, nr_irqs);
1119}
1120
1121static bool irq_domain_is_auto_recursive(struct irq_domain *domain)
1122{
1123	return domain->flags & IRQ_DOMAIN_FLAG_AUTO_RECURSIVE;
1124}
1125
1126static void irq_domain_free_irqs_recursive(struct irq_domain *domain,
1127					   unsigned int irq_base,
1128					   unsigned int nr_irqs)
1129{
1130	domain->ops->free(domain, irq_base, nr_irqs);
1131	if (irq_domain_is_auto_recursive(domain)) {
1132		BUG_ON(!domain->parent);
1133		irq_domain_free_irqs_recursive(domain->parent, irq_base,
1134					       nr_irqs);
1135	}
1136}
1137
1138int irq_domain_alloc_irqs_recursive(struct irq_domain *domain,
1139				    unsigned int irq_base,
1140				    unsigned int nr_irqs, void *arg)
1141{
1142	int ret = 0;
1143	struct irq_domain *parent = domain->parent;
1144	bool recursive = irq_domain_is_auto_recursive(domain);
1145
1146	BUG_ON(recursive && !parent);
1147	if (recursive)
1148		ret = irq_domain_alloc_irqs_recursive(parent, irq_base,
1149						      nr_irqs, arg);
1150	if (ret >= 0)
1151		ret = domain->ops->alloc(domain, irq_base, nr_irqs, arg);
1152	if (ret < 0 && recursive)
1153		irq_domain_free_irqs_recursive(parent, irq_base, nr_irqs);
1154
1155	return ret;
1156}
1157
1158/**
1159 * __irq_domain_alloc_irqs - Allocate IRQs from domain
1160 * @domain:	domain to allocate from
1161 * @irq_base:	allocate specified IRQ nubmer if irq_base >= 0
1162 * @nr_irqs:	number of IRQs to allocate
1163 * @node:	NUMA node id for memory allocation
1164 * @arg:	domain specific argument
1165 * @realloc:	IRQ descriptors have already been allocated if true
1166 *
1167 * Allocate IRQ numbers and initialized all data structures to support
1168 * hierarchy IRQ domains.
1169 * Parameter @realloc is mainly to support legacy IRQs.
1170 * Returns error code or allocated IRQ number
1171 *
1172 * The whole process to setup an IRQ has been split into two steps.
1173 * The first step, __irq_domain_alloc_irqs(), is to allocate IRQ
1174 * descriptor and required hardware resources. The second step,
1175 * irq_domain_activate_irq(), is to program hardwares with preallocated
1176 * resources. In this way, it's easier to rollback when failing to
1177 * allocate resources.
1178 */
1179int __irq_domain_alloc_irqs(struct irq_domain *domain, int irq_base,
1180			    unsigned int nr_irqs, int node, void *arg,
1181			    bool realloc)
1182{
1183	int i, ret, virq;
1184
1185	if (domain == NULL) {
1186		domain = irq_default_domain;
1187		if (WARN(!domain, "domain is NULL; cannot allocate IRQ\n"))
1188			return -EINVAL;
1189	}
1190
1191	if (!domain->ops->alloc) {
1192		pr_debug("domain->ops->alloc() is NULL\n");
1193		return -ENOSYS;
1194	}
1195
1196	if (realloc && irq_base >= 0) {
1197		virq = irq_base;
1198	} else {
1199		virq = irq_domain_alloc_descs(irq_base, nr_irqs, 0, node);
1200		if (virq < 0) {
1201			pr_debug("cannot allocate IRQ(base %d, count %d)\n",
1202				 irq_base, nr_irqs);
1203			return virq;
1204		}
1205	}
1206
1207	if (irq_domain_alloc_irq_data(domain, virq, nr_irqs)) {
1208		pr_debug("cannot allocate memory for IRQ%d\n", virq);
1209		ret = -ENOMEM;
1210		goto out_free_desc;
1211	}
1212
1213	mutex_lock(&irq_domain_mutex);
1214	ret = irq_domain_alloc_irqs_recursive(domain, virq, nr_irqs, arg);
1215	if (ret < 0) {
1216		mutex_unlock(&irq_domain_mutex);
1217		goto out_free_irq_data;
1218	}
1219	for (i = 0; i < nr_irqs; i++)
1220		irq_domain_insert_irq(virq + i);
1221	mutex_unlock(&irq_domain_mutex);
1222
1223	return virq;
1224
1225out_free_irq_data:
1226	irq_domain_free_irq_data(virq, nr_irqs);
1227out_free_desc:
1228	irq_free_descs(virq, nr_irqs);
1229	return ret;
1230}
1231
1232/**
1233 * irq_domain_free_irqs - Free IRQ number and associated data structures
1234 * @virq:	base IRQ number
1235 * @nr_irqs:	number of IRQs to free
1236 */
1237void irq_domain_free_irqs(unsigned int virq, unsigned int nr_irqs)
1238{
1239	struct irq_data *data = irq_get_irq_data(virq);
1240	int i;
1241
1242	if (WARN(!data || !data->domain || !data->domain->ops->free,
1243		 "NULL pointer, cannot free irq\n"))
1244		return;
1245
1246	mutex_lock(&irq_domain_mutex);
1247	for (i = 0; i < nr_irqs; i++)
1248		irq_domain_remove_irq(virq + i);
1249	irq_domain_free_irqs_recursive(data->domain, virq, nr_irqs);
1250	mutex_unlock(&irq_domain_mutex);
1251
1252	irq_domain_free_irq_data(virq, nr_irqs);
1253	irq_free_descs(virq, nr_irqs);
1254}
1255
1256/**
1257 * irq_domain_alloc_irqs_parent - Allocate interrupts from parent domain
1258 * @irq_base:	Base IRQ number
1259 * @nr_irqs:	Number of IRQs to allocate
1260 * @arg:	Allocation data (arch/domain specific)
1261 *
1262 * Check whether the domain has been setup recursive. If not allocate
1263 * through the parent domain.
1264 */
1265int irq_domain_alloc_irqs_parent(struct irq_domain *domain,
1266				 unsigned int irq_base, unsigned int nr_irqs,
1267				 void *arg)
1268{
1269	/* irq_domain_alloc_irqs_recursive() has called parent's alloc() */
1270	if (irq_domain_is_auto_recursive(domain))
1271		return 0;
1272
1273	domain = domain->parent;
1274	if (domain)
1275		return irq_domain_alloc_irqs_recursive(domain, irq_base,
1276						       nr_irqs, arg);
1277	return -ENOSYS;
1278}
1279EXPORT_SYMBOL_GPL(irq_domain_alloc_irqs_parent);
1280
1281/**
1282 * irq_domain_free_irqs_parent - Free interrupts from parent domain
1283 * @irq_base:	Base IRQ number
1284 * @nr_irqs:	Number of IRQs to free
1285 *
1286 * Check whether the domain has been setup recursive. If not free
1287 * through the parent domain.
1288 */
1289void irq_domain_free_irqs_parent(struct irq_domain *domain,
1290				 unsigned int irq_base, unsigned int nr_irqs)
1291{
1292	/* irq_domain_free_irqs_recursive() will call parent's free */
1293	if (!irq_domain_is_auto_recursive(domain) && domain->parent)
1294		irq_domain_free_irqs_recursive(domain->parent, irq_base,
1295					       nr_irqs);
1296}
1297EXPORT_SYMBOL_GPL(irq_domain_free_irqs_parent);
1298
1299/**
1300 * irq_domain_activate_irq - Call domain_ops->activate recursively to activate
1301 *			     interrupt
1302 * @irq_data:	outermost irq_data associated with interrupt
1303 *
1304 * This is the second step to call domain_ops->activate to program interrupt
1305 * controllers, so the interrupt could actually get delivered.
1306 */
1307void irq_domain_activate_irq(struct irq_data *irq_data)
1308{
1309	if (irq_data && irq_data->domain) {
1310		struct irq_domain *domain = irq_data->domain;
1311
1312		if (irq_data->parent_data)
1313			irq_domain_activate_irq(irq_data->parent_data);
1314		if (domain->ops->activate)
1315			domain->ops->activate(domain, irq_data);
1316	}
1317}
1318
1319/**
1320 * irq_domain_deactivate_irq - Call domain_ops->deactivate recursively to
1321 *			       deactivate interrupt
1322 * @irq_data: outermost irq_data associated with interrupt
1323 *
1324 * It calls domain_ops->deactivate to program interrupt controllers to disable
1325 * interrupt delivery.
1326 */
1327void irq_domain_deactivate_irq(struct irq_data *irq_data)
1328{
1329	if (irq_data && irq_data->domain) {
1330		struct irq_domain *domain = irq_data->domain;
1331
1332		if (domain->ops->deactivate)
1333			domain->ops->deactivate(domain, irq_data);
1334		if (irq_data->parent_data)
1335			irq_domain_deactivate_irq(irq_data->parent_data);
1336	}
1337}
1338
1339static void irq_domain_check_hierarchy(struct irq_domain *domain)
1340{
1341	/* Hierarchy irq_domains must implement callback alloc() */
1342	if (domain->ops->alloc)
1343		domain->flags |= IRQ_DOMAIN_FLAG_HIERARCHY;
1344}
1345#else	/* CONFIG_IRQ_DOMAIN_HIERARCHY */
1346/**
1347 * irq_domain_get_irq_data - Get irq_data associated with @virq and @domain
1348 * @domain:	domain to match
1349 * @virq:	IRQ number to get irq_data
1350 */
1351struct irq_data *irq_domain_get_irq_data(struct irq_domain *domain,
1352					 unsigned int virq)
1353{
1354	struct irq_data *irq_data = irq_get_irq_data(virq);
1355
1356	return (irq_data && irq_data->domain == domain) ? irq_data : NULL;
1357}
1358EXPORT_SYMBOL_GPL(irq_domain_get_irq_data);
1359
1360/**
1361 * irq_domain_set_info - Set the complete data for a @virq in @domain
1362 * @domain:		Interrupt domain to match
1363 * @virq:		IRQ number
1364 * @hwirq:		The hardware interrupt number
1365 * @chip:		The associated interrupt chip
1366 * @chip_data:		The associated interrupt chip data
1367 * @handler:		The interrupt flow handler
1368 * @handler_data:	The interrupt flow handler data
1369 * @handler_name:	The interrupt handler name
1370 */
1371void irq_domain_set_info(struct irq_domain *domain, unsigned int virq,
1372			 irq_hw_number_t hwirq, struct irq_chip *chip,
1373			 void *chip_data, irq_flow_handler_t handler,
1374			 void *handler_data, const char *handler_name)
1375{
1376	irq_set_chip_and_handler_name(virq, chip, handler, handler_name);
1377	irq_set_chip_data(virq, chip_data);
1378	irq_set_handler_data(virq, handler_data);
1379}
1380
1381static void irq_domain_check_hierarchy(struct irq_domain *domain)
1382{
1383}
1384#endif	/* CONFIG_IRQ_DOMAIN_HIERARCHY */
v3.5.6
  1#define pr_fmt(fmt)  "irq: " fmt
  2
  3#include <linux/debugfs.h>
  4#include <linux/hardirq.h>
  5#include <linux/interrupt.h>
  6#include <linux/irq.h>
  7#include <linux/irqdesc.h>
  8#include <linux/irqdomain.h>
  9#include <linux/module.h>
 10#include <linux/mutex.h>
 11#include <linux/of.h>
 12#include <linux/of_address.h>
 
 
 13#include <linux/seq_file.h>
 14#include <linux/slab.h>
 15#include <linux/smp.h>
 16#include <linux/fs.h>
 17
 18#define IRQ_DOMAIN_MAP_LEGACY 0 /* driver allocated fixed range of irqs.
 19				 * ie. legacy 8259, gets irqs 1..15 */
 20#define IRQ_DOMAIN_MAP_NOMAP 1 /* no fast reverse mapping */
 21#define IRQ_DOMAIN_MAP_LINEAR 2 /* linear map of interrupts */
 22#define IRQ_DOMAIN_MAP_TREE 3 /* radix tree */
 23
 24static LIST_HEAD(irq_domain_list);
 25static DEFINE_MUTEX(irq_domain_mutex);
 26
 27static DEFINE_MUTEX(revmap_trees_mutex);
 28static struct irq_domain *irq_default_domain;
 29
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 30/**
 31 * irq_domain_alloc() - Allocate a new irq_domain data structure
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 32 * @of_node: optional device-tree node of the interrupt controller
 33 * @revmap_type: type of reverse mapping to use
 34 * @ops: map/unmap domain callbacks
 
 
 
 35 * @host_data: Controller private data pointer
 36 *
 37 * Allocates and initialize and irq_domain structure.  Caller is expected to
 38 * register allocated irq_domain with irq_domain_register().  Returns pointer
 39 * to IRQ domain, or NULL on failure.
 40 */
 41static struct irq_domain *irq_domain_alloc(struct device_node *of_node,
 42					   unsigned int revmap_type,
 43					   const struct irq_domain_ops *ops,
 44					   void *host_data)
 45{
 46	struct irq_domain *domain;
 
 
 
 47
 48	domain = kzalloc(sizeof(*domain), GFP_KERNEL);
 
 49	if (WARN_ON(!domain))
 50		return NULL;
 51
 
 
 52	/* Fill structure */
 53	domain->revmap_type = revmap_type;
 54	domain->ops = ops;
 55	domain->host_data = host_data;
 56	domain->of_node = of_node_get(of_node);
 57
 58	return domain;
 59}
 60
 61static void irq_domain_free(struct irq_domain *domain)
 62{
 63	of_node_put(domain->of_node);
 64	kfree(domain);
 65}
 66
 67static void irq_domain_add(struct irq_domain *domain)
 68{
 69	mutex_lock(&irq_domain_mutex);
 70	list_add(&domain->link, &irq_domain_list);
 71	mutex_unlock(&irq_domain_mutex);
 72	pr_debug("Allocated domain of type %d @0x%p\n",
 73		 domain->revmap_type, domain);
 
 74}
 
 75
 76/**
 77 * irq_domain_remove() - Remove an irq domain.
 78 * @domain: domain to remove
 79 *
 80 * This routine is used to remove an irq domain. The caller must ensure
 81 * that all mappings within the domain have been disposed of prior to
 82 * use, depending on the revmap type.
 83 */
 84void irq_domain_remove(struct irq_domain *domain)
 85{
 86	mutex_lock(&irq_domain_mutex);
 87
 88	switch (domain->revmap_type) {
 89	case IRQ_DOMAIN_MAP_LEGACY:
 90		/*
 91		 * Legacy domains don't manage their own irq_desc
 92		 * allocations, we expect the caller to handle irq_desc
 93		 * freeing on their own.
 94		 */
 95		break;
 96	case IRQ_DOMAIN_MAP_TREE:
 97		/*
 98		 * radix_tree_delete() takes care of destroying the root
 99		 * node when all entries are removed. Shout if there are
100		 * any mappings left.
101		 */
102		WARN_ON(domain->revmap_data.tree.height);
103		break;
104	case IRQ_DOMAIN_MAP_LINEAR:
105		kfree(domain->revmap_data.linear.revmap);
106		domain->revmap_data.linear.size = 0;
107		break;
108	case IRQ_DOMAIN_MAP_NOMAP:
109		break;
110	}
111
112	list_del(&domain->link);
113
114	/*
115	 * If the going away domain is the default one, reset it.
116	 */
117	if (unlikely(irq_default_domain == domain))
118		irq_set_default_host(NULL);
119
120	mutex_unlock(&irq_domain_mutex);
121
122	pr_debug("Removed domain of type %d @0x%p\n",
123		 domain->revmap_type, domain);
124
125	irq_domain_free(domain);
 
126}
127EXPORT_SYMBOL_GPL(irq_domain_remove);
128
129static unsigned int irq_domain_legacy_revmap(struct irq_domain *domain,
130					     irq_hw_number_t hwirq)
131{
132	irq_hw_number_t first_hwirq = domain->revmap_data.legacy.first_hwirq;
133	int size = domain->revmap_data.legacy.size;
134
135	if (WARN_ON(hwirq < first_hwirq || hwirq >= first_hwirq + size))
136		return 0;
137	return hwirq - first_hwirq + domain->revmap_data.legacy.first_irq;
138}
139
140/**
141 * irq_domain_add_legacy() - Allocate and register a legacy revmap irq_domain.
142 * @of_node: pointer to interrupt controller's device tree node.
143 * @size: total number of irqs in legacy mapping
144 * @first_irq: first number of irq block assigned to the domain
145 * @first_hwirq: first hwirq number to use for the translation. Should normally
146 *               be '0', but a positive integer can be used if the effective
147 *               hwirqs numbering does not begin at zero.
148 * @ops: map/unmap domain callbacks
149 * @host_data: Controller private data pointer
150 *
151 * Note: the map() callback will be called before this function returns
152 * for all legacy interrupts except 0 (which is always the invalid irq for
153 * a legacy controller).
 
 
 
 
154 */
155struct irq_domain *irq_domain_add_legacy(struct device_node *of_node,
156					 unsigned int size,
157					 unsigned int first_irq,
158					 irq_hw_number_t first_hwirq,
159					 const struct irq_domain_ops *ops,
160					 void *host_data)
161{
162	struct irq_domain *domain;
163	unsigned int i;
164
165	domain = irq_domain_alloc(of_node, IRQ_DOMAIN_MAP_LEGACY, ops, host_data);
166	if (!domain)
167		return NULL;
168
169	domain->revmap_data.legacy.first_irq = first_irq;
170	domain->revmap_data.legacy.first_hwirq = first_hwirq;
171	domain->revmap_data.legacy.size = size;
172
173	mutex_lock(&irq_domain_mutex);
174	/* Verify that all the irqs are available */
175	for (i = 0; i < size; i++) {
176		int irq = first_irq + i;
177		struct irq_data *irq_data = irq_get_irq_data(irq);
178
179		if (WARN_ON(!irq_data || irq_data->domain)) {
180			mutex_unlock(&irq_domain_mutex);
181			irq_domain_free(domain);
182			return NULL;
183		}
 
184	}
185
186	/* Claim all of the irqs before registering a legacy domain */
187	for (i = 0; i < size; i++) {
188		struct irq_data *irq_data = irq_get_irq_data(first_irq + i);
189		irq_data->hwirq = first_hwirq + i;
190		irq_data->domain = domain;
191	}
192	mutex_unlock(&irq_domain_mutex);
193
194	for (i = 0; i < size; i++) {
195		int irq = first_irq + i;
196		int hwirq = first_hwirq + i;
197
198		/* IRQ0 gets ignored */
199		if (!irq)
200			continue;
201
202		/* Legacy flags are left to default at this point,
203		 * one can then use irq_create_mapping() to
204		 * explicitly change them
205		 */
206		ops->map(domain, irq, hwirq);
207
208		/* Clear norequest flags */
209		irq_clear_status_flags(irq, IRQ_NOREQUEST);
210	}
211
212	irq_domain_add(domain);
213	return domain;
214}
215EXPORT_SYMBOL_GPL(irq_domain_add_legacy);
216
217/**
218 * irq_domain_add_linear() - Allocate and register a legacy revmap irq_domain.
219 * @of_node: pointer to interrupt controller's device tree node.
220 * @size: Number of interrupts in the domain.
 
 
 
 
221 * @ops: map/unmap domain callbacks
222 * @host_data: Controller private data pointer
 
 
 
 
223 */
224struct irq_domain *irq_domain_add_linear(struct device_node *of_node,
225					 unsigned int size,
 
 
226					 const struct irq_domain_ops *ops,
227					 void *host_data)
228{
229	struct irq_domain *domain;
230	unsigned int *revmap;
231
232	revmap = kzalloc(sizeof(*revmap) * size, GFP_KERNEL);
233	if (WARN_ON(!revmap))
234		return NULL;
 
235
236	domain = irq_domain_alloc(of_node, IRQ_DOMAIN_MAP_LINEAR, ops, host_data);
237	if (!domain) {
238		kfree(revmap);
239		return NULL;
240	}
241	domain->revmap_data.linear.size = size;
242	domain->revmap_data.linear.revmap = revmap;
243	irq_domain_add(domain);
244	return domain;
245}
246EXPORT_SYMBOL_GPL(irq_domain_add_linear);
247
248struct irq_domain *irq_domain_add_nomap(struct device_node *of_node,
249					 unsigned int max_irq,
250					 const struct irq_domain_ops *ops,
251					 void *host_data)
252{
253	struct irq_domain *domain = irq_domain_alloc(of_node,
254					IRQ_DOMAIN_MAP_NOMAP, ops, host_data);
255	if (domain) {
256		domain->revmap_data.nomap.max_irq = max_irq ? max_irq : ~0;
257		irq_domain_add(domain);
258	}
259	return domain;
260}
261EXPORT_SYMBOL_GPL(irq_domain_add_nomap);
262
263/**
264 * irq_domain_add_tree()
265 * @of_node: pointer to interrupt controller's device tree node.
266 * @ops: map/unmap domain callbacks
267 *
268 * Note: The radix tree will be allocated later during boot automatically
269 * (the reverse mapping will use the slow path until that happens).
270 */
271struct irq_domain *irq_domain_add_tree(struct device_node *of_node,
272					 const struct irq_domain_ops *ops,
273					 void *host_data)
274{
275	struct irq_domain *domain = irq_domain_alloc(of_node,
276					IRQ_DOMAIN_MAP_TREE, ops, host_data);
277	if (domain) {
278		INIT_RADIX_TREE(&domain->revmap_data.tree, GFP_KERNEL);
279		irq_domain_add(domain);
280	}
281	return domain;
282}
283EXPORT_SYMBOL_GPL(irq_domain_add_tree);
284
285/**
286 * irq_find_host() - Locates a domain for a given device node
287 * @node: device-tree node of the interrupt controller
288 */
289struct irq_domain *irq_find_host(struct device_node *node)
290{
291	struct irq_domain *h, *found = NULL;
292	int rc;
293
294	/* We might want to match the legacy controller last since
295	 * it might potentially be set to match all interrupts in
296	 * the absence of a device node. This isn't a problem so far
297	 * yet though...
 
 
 
 
298	 */
299	mutex_lock(&irq_domain_mutex);
300	list_for_each_entry(h, &irq_domain_list, link) {
301		if (h->ops->match)
302			rc = h->ops->match(h, node);
303		else
304			rc = (h->of_node != NULL) && (h->of_node == node);
 
 
305
306		if (rc) {
307			found = h;
308			break;
309		}
310	}
311	mutex_unlock(&irq_domain_mutex);
312	return found;
313}
314EXPORT_SYMBOL_GPL(irq_find_host);
315
316/**
317 * irq_set_default_host() - Set a "default" irq domain
318 * @domain: default domain pointer
319 *
320 * For convenience, it's possible to set a "default" domain that will be used
321 * whenever NULL is passed to irq_create_mapping(). It makes life easier for
322 * platforms that want to manipulate a few hard coded interrupt numbers that
323 * aren't properly represented in the device-tree.
324 */
325void irq_set_default_host(struct irq_domain *domain)
326{
327	pr_debug("Default domain set to @0x%p\n", domain);
328
329	irq_default_domain = domain;
330}
331EXPORT_SYMBOL_GPL(irq_set_default_host);
332
333static int irq_setup_virq(struct irq_domain *domain, unsigned int virq,
334			    irq_hw_number_t hwirq)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
335{
336	struct irq_data *irq_data = irq_get_irq_data(virq);
 
 
 
 
 
 
 
 
 
337
 
338	irq_data->hwirq = hwirq;
339	irq_data->domain = domain;
340	if (domain->ops->map(domain, virq, hwirq)) {
341		pr_debug("irq-%i==>hwirq-0x%lx mapping failed\n", virq, hwirq);
342		irq_data->domain = NULL;
343		irq_data->hwirq = 0;
344		return -1;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
345	}
 
346
347	irq_clear_status_flags(virq, IRQ_NOREQUEST);
348
349	return 0;
350}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
351
352/**
353 * irq_create_direct_mapping() - Allocate an irq for direct mapping
354 * @domain: domain to allocate the irq for or NULL for default domain
355 *
356 * This routine is used for irq controllers which can choose the hardware
357 * interrupt numbers they generate. In such a case it's simplest to use
358 * the linux irq as the hardware interrupt number.
 
 
359 */
360unsigned int irq_create_direct_mapping(struct irq_domain *domain)
361{
 
362	unsigned int virq;
363
364	if (domain == NULL)
365		domain = irq_default_domain;
366
367	BUG_ON(domain == NULL);
368	WARN_ON(domain->revmap_type != IRQ_DOMAIN_MAP_NOMAP);
369
370	virq = irq_alloc_desc_from(1, 0);
371	if (!virq) {
372		pr_debug("create_direct virq allocation failed\n");
373		return 0;
374	}
375	if (virq >= domain->revmap_data.nomap.max_irq) {
376		pr_err("ERROR: no free irqs available below %i maximum\n",
377			domain->revmap_data.nomap.max_irq);
378		irq_free_desc(virq);
379		return 0;
380	}
381	pr_debug("create_direct obtained virq %d\n", virq);
382
383	if (irq_setup_virq(domain, virq, virq)) {
384		irq_free_desc(virq);
385		return 0;
386	}
387
388	return virq;
389}
390EXPORT_SYMBOL_GPL(irq_create_direct_mapping);
391
392/**
393 * irq_create_mapping() - Map a hardware interrupt into linux irq space
394 * @domain: domain owning this hardware interrupt or NULL for default domain
395 * @hwirq: hardware irq number in that domain space
396 *
397 * Only one mapping per hardware interrupt is permitted. Returns a linux
398 * irq number.
399 * If the sense/trigger is to be specified, set_irq_type() should be called
400 * on the number returned from that call.
401 */
402unsigned int irq_create_mapping(struct irq_domain *domain,
403				irq_hw_number_t hwirq)
404{
405	unsigned int hint;
406	int virq;
407
408	pr_debug("irq_create_mapping(0x%p, 0x%lx)\n", domain, hwirq);
409
410	/* Look for default domain if nececssary */
411	if (domain == NULL)
412		domain = irq_default_domain;
413	if (domain == NULL) {
414		pr_warning("irq_create_mapping called for"
415			   " NULL domain, hwirq=%lx\n", hwirq);
416		WARN_ON(1);
417		return 0;
418	}
419	pr_debug("-> using domain @%p\n", domain);
420
 
 
421	/* Check if mapping already exists */
422	virq = irq_find_mapping(domain, hwirq);
423	if (virq) {
424		pr_debug("-> existing mapping on virq %d\n", virq);
425		return virq;
426	}
427
428	/* Get a virtual interrupt number */
429	if (domain->revmap_type == IRQ_DOMAIN_MAP_LEGACY)
430		return irq_domain_legacy_revmap(domain, hwirq);
431
432	/* Allocate a virtual interrupt number */
433	hint = hwirq % nr_irqs;
434	if (hint == 0)
435		hint++;
436	virq = irq_alloc_desc_from(hint, 0);
437	if (virq <= 0)
438		virq = irq_alloc_desc_from(1, 0);
439	if (virq <= 0) {
440		pr_debug("-> virq allocation failed\n");
441		return 0;
442	}
443
444	if (irq_setup_virq(domain, virq, hwirq)) {
445		if (domain->revmap_type != IRQ_DOMAIN_MAP_LEGACY)
446			irq_free_desc(virq);
447		return 0;
448	}
449
450	pr_debug("irq %lu on domain %s mapped to virtual irq %u\n",
451		hwirq, domain->of_node ? domain->of_node->full_name : "null", virq);
452
453	return virq;
454}
455EXPORT_SYMBOL_GPL(irq_create_mapping);
456
457unsigned int irq_create_of_mapping(struct device_node *controller,
458				   const u32 *intspec, unsigned int intsize)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
459{
460	struct irq_domain *domain;
461	irq_hw_number_t hwirq;
462	unsigned int type = IRQ_TYPE_NONE;
463	unsigned int virq;
 
 
 
 
 
 
 
 
 
 
464
465	domain = controller ? irq_find_host(controller) : irq_default_domain;
466	if (!domain) {
467#ifdef CONFIG_MIPS
 
 
 
 
 
 
 
 
468		/*
469		 * Workaround to avoid breaking interrupt controller drivers
470		 * that don't yet register an irq_domain.  This is temporary
471		 * code. ~~~gcl, Feb 24, 2012
472		 *
473		 * Scheduled for removal in Linux v3.6.  That should be enough
474		 * time.
475		 */
476		if (intsize > 0)
477			return intspec[0];
478#endif
479		pr_warning("no irq domain found for %s !\n",
480			   controller->full_name);
481		return 0;
482	}
483
484	/* If domain has no translation, then we assume interrupt line */
485	if (domain->ops->xlate == NULL)
486		hwirq = intspec[0];
487	else {
488		if (domain->ops->xlate(domain, controller, intspec, intsize,
489				     &hwirq, &type))
490			return 0;
 
 
 
 
 
491	}
492
493	/* Create mapping */
494	virq = irq_create_mapping(domain, hwirq);
495	if (!virq)
496		return virq;
497
498	/* Set type if specified and different than the current one */
499	if (type != IRQ_TYPE_NONE &&
500	    type != (irqd_get_trigger_type(irq_get_irq_data(virq))))
501		irq_set_irq_type(virq, type);
502	return virq;
503}
 
 
 
 
 
 
 
 
 
504EXPORT_SYMBOL_GPL(irq_create_of_mapping);
505
506/**
507 * irq_dispose_mapping() - Unmap an interrupt
508 * @virq: linux irq number of the interrupt to unmap
509 */
510void irq_dispose_mapping(unsigned int virq)
511{
512	struct irq_data *irq_data = irq_get_irq_data(virq);
513	struct irq_domain *domain;
514	irq_hw_number_t hwirq;
515
516	if (!virq || !irq_data)
517		return;
518
519	domain = irq_data->domain;
520	if (WARN_ON(domain == NULL))
521		return;
522
523	/* Never unmap legacy interrupts */
524	if (domain->revmap_type == IRQ_DOMAIN_MAP_LEGACY)
525		return;
526
527	irq_set_status_flags(virq, IRQ_NOREQUEST);
528
529	/* remove chip and handler */
530	irq_set_chip_and_handler(virq, NULL, NULL);
531
532	/* Make sure it's completed */
533	synchronize_irq(virq);
534
535	/* Tell the PIC about it */
536	if (domain->ops->unmap)
537		domain->ops->unmap(domain, virq);
538	smp_mb();
539
540	/* Clear reverse map */
541	hwirq = irq_data->hwirq;
542	switch(domain->revmap_type) {
543	case IRQ_DOMAIN_MAP_LINEAR:
544		if (hwirq < domain->revmap_data.linear.size)
545			domain->revmap_data.linear.revmap[hwirq] = 0;
546		break;
547	case IRQ_DOMAIN_MAP_TREE:
548		mutex_lock(&revmap_trees_mutex);
549		radix_tree_delete(&domain->revmap_data.tree, hwirq);
550		mutex_unlock(&revmap_trees_mutex);
551		break;
552	}
553
554	irq_free_desc(virq);
555}
556EXPORT_SYMBOL_GPL(irq_dispose_mapping);
557
558/**
559 * irq_find_mapping() - Find a linux irq from an hw irq number.
560 * @domain: domain owning this hardware interrupt
561 * @hwirq: hardware irq number in that domain space
562 *
563 * This is a slow path, for use by generic code. It's expected that an
564 * irq controller implementation directly calls the appropriate low level
565 * mapping function.
566 */
567unsigned int irq_find_mapping(struct irq_domain *domain,
568			      irq_hw_number_t hwirq)
569{
570	unsigned int i;
571	unsigned int hint = hwirq % nr_irqs;
572
573	/* Look for default domain if nececssary */
574	if (domain == NULL)
575		domain = irq_default_domain;
576	if (domain == NULL)
577		return 0;
578
579	/* legacy -> bail early */
580	if (domain->revmap_type == IRQ_DOMAIN_MAP_LEGACY)
581		return irq_domain_legacy_revmap(domain, hwirq);
582
583	/* Slow path does a linear search of the map */
584	if (hint == 0)
585		hint = 1;
586	i = hint;
587	do {
588		struct irq_data *data = irq_get_irq_data(i);
589		if (data && (data->domain == domain) && (data->hwirq == hwirq))
590			return i;
591		i++;
592		if (i >= nr_irqs)
593			i = 1;
594	} while(i != hint);
595	return 0;
596}
597EXPORT_SYMBOL_GPL(irq_find_mapping);
598
599/**
600 * irq_radix_revmap_lookup() - Find a linux irq from a hw irq number.
601 * @domain: domain owning this hardware interrupt
602 * @hwirq: hardware irq number in that domain space
603 *
604 * This is a fast path, for use by irq controller code that uses radix tree
605 * revmaps
606 */
607unsigned int irq_radix_revmap_lookup(struct irq_domain *domain,
608				     irq_hw_number_t hwirq)
609{
610	struct irq_data *irq_data;
611
612	if (WARN_ON_ONCE(domain->revmap_type != IRQ_DOMAIN_MAP_TREE))
613		return irq_find_mapping(domain, hwirq);
614
615	/*
616	 * Freeing an irq can delete nodes along the path to
617	 * do the lookup via call_rcu.
618	 */
619	rcu_read_lock();
620	irq_data = radix_tree_lookup(&domain->revmap_data.tree, hwirq);
621	rcu_read_unlock();
622
623	/*
624	 * If found in radix tree, then fine.
625	 * Else fallback to linear lookup - this should not happen in practice
626	 * as it means that we failed to insert the node in the radix tree.
627	 */
628	return irq_data ? irq_data->irq : irq_find_mapping(domain, hwirq);
629}
630EXPORT_SYMBOL_GPL(irq_radix_revmap_lookup);
631
632/**
633 * irq_radix_revmap_insert() - Insert a hw irq to linux irq number mapping.
634 * @domain: domain owning this hardware interrupt
635 * @virq: linux irq number
636 * @hwirq: hardware irq number in that domain space
637 *
638 * This is for use by irq controllers that use a radix tree reverse
639 * mapping for fast lookup.
640 */
641void irq_radix_revmap_insert(struct irq_domain *domain, unsigned int virq,
642			     irq_hw_number_t hwirq)
643{
644	struct irq_data *irq_data = irq_get_irq_data(virq);
645
646	if (WARN_ON(domain->revmap_type != IRQ_DOMAIN_MAP_TREE))
647		return;
648
649	if (virq) {
650		mutex_lock(&revmap_trees_mutex);
651		radix_tree_insert(&domain->revmap_data.tree, hwirq, irq_data);
652		mutex_unlock(&revmap_trees_mutex);
653	}
654}
655EXPORT_SYMBOL_GPL(irq_radix_revmap_insert);
656
657/**
658 * irq_linear_revmap() - Find a linux irq from a hw irq number.
659 * @domain: domain owning this hardware interrupt
660 * @hwirq: hardware irq number in that domain space
661 *
662 * This is a fast path, for use by irq controller code that uses linear
663 * revmaps. It does fallback to the slow path if the revmap doesn't exist
664 * yet and will create the revmap entry with appropriate locking
665 */
666unsigned int irq_linear_revmap(struct irq_domain *domain,
667			       irq_hw_number_t hwirq)
668{
669	unsigned int *revmap;
670
671	if (WARN_ON_ONCE(domain->revmap_type != IRQ_DOMAIN_MAP_LINEAR))
672		return irq_find_mapping(domain, hwirq);
673
674	/* Check revmap bounds */
675	if (unlikely(hwirq >= domain->revmap_data.linear.size))
676		return irq_find_mapping(domain, hwirq);
677
678	/* Check if revmap was allocated */
679	revmap = domain->revmap_data.linear.revmap;
680	if (unlikely(revmap == NULL))
681		return irq_find_mapping(domain, hwirq);
682
683	/* Fill up revmap with slow path if no mapping found */
684	if (unlikely(!revmap[hwirq]))
685		revmap[hwirq] = irq_find_mapping(domain, hwirq);
686
687	return revmap[hwirq];
688}
689EXPORT_SYMBOL_GPL(irq_linear_revmap);
690
691#ifdef CONFIG_IRQ_DOMAIN_DEBUG
692static int virq_debug_show(struct seq_file *m, void *private)
693{
694	unsigned long flags;
695	struct irq_desc *desc;
696	const char *p;
697	static const char none[] = "none";
698	void *data;
699	int i;
700
701	seq_printf(m, "%-5s  %-7s  %-15s  %-*s  %s\n", "irq", "hwirq",
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
702		      "chip name", (int)(2 * sizeof(void *) + 2), "chip data",
703		      "domain name");
704
705	for (i = 1; i < nr_irqs; i++) {
706		desc = irq_to_desc(i);
707		if (!desc)
708			continue;
709
710		raw_spin_lock_irqsave(&desc->lock, flags);
 
711
712		if (desc->action && desc->action->handler) {
713			struct irq_chip *chip;
 
 
714
715			seq_printf(m, "%5d  ", i);
716			seq_printf(m, "0x%05lx  ", desc->irq_data.hwirq);
717
718			chip = irq_desc_get_chip(desc);
719			if (chip && chip->name)
720				p = chip->name;
721			else
722				p = none;
723			seq_printf(m, "%-15s  ", p);
724
725			data = irq_desc_get_chip_data(desc);
726			seq_printf(m, data ? "0x%p  " : "  %p  ", data);
727
728			if (desc->irq_data.domain && desc->irq_data.domain->of_node)
729				p = desc->irq_data.domain->of_node->full_name;
730			else
731				p = none;
732			seq_printf(m, "%s\n", p);
 
733		}
734
735		raw_spin_unlock_irqrestore(&desc->lock, flags);
736	}
737
738	return 0;
739}
740
741static int virq_debug_open(struct inode *inode, struct file *file)
742{
743	return single_open(file, virq_debug_show, inode->i_private);
744}
745
746static const struct file_operations virq_debug_fops = {
747	.open = virq_debug_open,
748	.read = seq_read,
749	.llseek = seq_lseek,
750	.release = single_release,
751};
752
753static int __init irq_debugfs_init(void)
754{
755	if (debugfs_create_file("irq_domain_mapping", S_IRUGO, NULL,
756				 NULL, &virq_debug_fops) == NULL)
757		return -ENOMEM;
758
759	return 0;
760}
761__initcall(irq_debugfs_init);
762#endif /* CONFIG_IRQ_DOMAIN_DEBUG */
763
764static int irq_domain_simple_map(struct irq_domain *d, unsigned int irq,
765				 irq_hw_number_t hwirq)
766{
767	return 0;
768}
769
770/**
771 * irq_domain_xlate_onecell() - Generic xlate for direct one cell bindings
772 *
773 * Device Tree IRQ specifier translation function which works with one cell
774 * bindings where the cell value maps directly to the hwirq number.
775 */
776int irq_domain_xlate_onecell(struct irq_domain *d, struct device_node *ctrlr,
777			     const u32 *intspec, unsigned int intsize,
778			     unsigned long *out_hwirq, unsigned int *out_type)
779{
780	if (WARN_ON(intsize < 1))
781		return -EINVAL;
782	*out_hwirq = intspec[0];
783	*out_type = IRQ_TYPE_NONE;
784	return 0;
785}
786EXPORT_SYMBOL_GPL(irq_domain_xlate_onecell);
787
788/**
789 * irq_domain_xlate_twocell() - Generic xlate for direct two cell bindings
790 *
791 * Device Tree IRQ specifier translation function which works with two cell
792 * bindings where the cell values map directly to the hwirq number
793 * and linux irq flags.
794 */
795int irq_domain_xlate_twocell(struct irq_domain *d, struct device_node *ctrlr,
796			const u32 *intspec, unsigned int intsize,
797			irq_hw_number_t *out_hwirq, unsigned int *out_type)
798{
799	if (WARN_ON(intsize < 2))
800		return -EINVAL;
801	*out_hwirq = intspec[0];
802	*out_type = intspec[1] & IRQ_TYPE_SENSE_MASK;
803	return 0;
804}
805EXPORT_SYMBOL_GPL(irq_domain_xlate_twocell);
806
807/**
808 * irq_domain_xlate_onetwocell() - Generic xlate for one or two cell bindings
809 *
810 * Device Tree IRQ specifier translation function which works with either one
811 * or two cell bindings where the cell values map directly to the hwirq number
812 * and linux irq flags.
813 *
814 * Note: don't use this function unless your interrupt controller explicitly
815 * supports both one and two cell bindings.  For the majority of controllers
816 * the _onecell() or _twocell() variants above should be used.
817 */
818int irq_domain_xlate_onetwocell(struct irq_domain *d,
819				struct device_node *ctrlr,
820				const u32 *intspec, unsigned int intsize,
821				unsigned long *out_hwirq, unsigned int *out_type)
822{
823	if (WARN_ON(intsize < 1))
824		return -EINVAL;
825	*out_hwirq = intspec[0];
826	*out_type = (intsize > 1) ? intspec[1] : IRQ_TYPE_NONE;
827	return 0;
828}
829EXPORT_SYMBOL_GPL(irq_domain_xlate_onetwocell);
830
831const struct irq_domain_ops irq_domain_simple_ops = {
832	.map = irq_domain_simple_map,
833	.xlate = irq_domain_xlate_onetwocell,
834};
835EXPORT_SYMBOL_GPL(irq_domain_simple_ops);
836
837#ifdef CONFIG_OF_IRQ
838void irq_domain_generate_simple(const struct of_device_id *match,
839				u64 phys_base, unsigned int irq_start)
840{
841	struct device_node *node;
842	pr_debug("looking for phys_base=%llx, irq_start=%i\n",
843		(unsigned long long) phys_base, (int) irq_start);
844	node = of_find_matching_node_by_address(NULL, match, phys_base);
845	if (node)
846		irq_domain_add_legacy(node, 32, irq_start, 0,
847				      &irq_domain_simple_ops, NULL);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
848}
849EXPORT_SYMBOL_GPL(irq_domain_generate_simple);
850#endif