Home | History | Annotate | Line # | Download | only in amdgpu
amdgpu_irq.c revision 1.1.1.2
      1 /*	$NetBSD: amdgpu_irq.c,v 1.1.1.2 2021/12/18 20:11:09 riastradh Exp $	*/
      2 
      3 /*
      4  * Copyright 2008 Advanced Micro Devices, Inc.
      5  * Copyright 2008 Red Hat Inc.
      6  * Copyright 2009 Jerome Glisse.
      7  *
      8  * Permission is hereby granted, free of charge, to any person obtaining a
      9  * copy of this software and associated documentation files (the "Software"),
     10  * to deal in the Software without restriction, including without limitation
     11  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
     12  * and/or sell copies of the Software, and to permit persons to whom the
     13  * Software is furnished to do so, subject to the following conditions:
     14  *
     15  * The above copyright notice and this permission notice shall be included in
     16  * all copies or substantial portions of the Software.
     17  *
     18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
     19  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
     20  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
     21  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
     22  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
     23  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
     24  * OTHER DEALINGS IN THE SOFTWARE.
     25  *
     26  * Authors: Dave Airlie
     27  *          Alex Deucher
     28  *          Jerome Glisse
     29  */
     30 
     31 /**
     32  * DOC: Interrupt Handling
     33  *
     34  * Interrupts generated within GPU hardware raise interrupt requests that are
     35  * passed to amdgpu IRQ handler which is responsible for detecting source and
     36  * type of the interrupt and dispatching matching handlers. If handling an
     37  * interrupt requires calling kernel functions that may sleep processing is
     38  * dispatched to work handlers.
     39  *
     40  * If MSI functionality is not disabled by module parameter then MSI
     41  * support will be enabled.
     42  *
     43  * For GPU interrupt sources that may be driven by another driver, IRQ domain
     44  * support is used (with mapping between virtual and hardware IRQs).
     45  */
     46 
     47 #include <sys/cdefs.h>
     48 __KERNEL_RCSID(0, "$NetBSD: amdgpu_irq.c,v 1.1.1.2 2021/12/18 20:11:09 riastradh Exp $");
     49 
     50 #include <linux/irq.h>
     51 #include <linux/pci.h>
     52 
     53 #include <drm/drm_crtc_helper.h>
     54 #include <drm/drm_irq.h>
     55 #include <drm/drm_vblank.h>
     56 #include <drm/amdgpu_drm.h>
     57 #include "amdgpu.h"
     58 #include "amdgpu_ih.h"
     59 #include "atom.h"
     60 #include "amdgpu_connectors.h"
     61 #include "amdgpu_trace.h"
     62 #include "amdgpu_amdkfd.h"
     63 #include "amdgpu_ras.h"
     64 
     65 #include <linux/pm_runtime.h>
     66 
     67 #ifdef CONFIG_DRM_AMD_DC
     68 #include "amdgpu_dm_irq.h"
     69 #endif
     70 
     71 #define AMDGPU_WAIT_IDLE_TIMEOUT 200
     72 
     73 /**
     74  * amdgpu_hotplug_work_func - work handler for display hotplug event
     75  *
     76  * @work: work struct pointer
     77  *
     78  * This is the hotplug event work handler (all ASICs).
     79  * The work gets scheduled from the IRQ handler if there
     80  * was a hotplug interrupt.  It walks through the connector table
     81  * and calls hotplug handler for each connector. After this, it sends
     82  * a DRM hotplug event to alert userspace.
     83  *
     84  * This design approach is required in order to defer hotplug event handling
     85  * from the IRQ handler to a work handler because hotplug handler has to use
     86  * mutexes which cannot be locked in an IRQ handler (since &mutex_lock may
     87  * sleep).
     88  */
     89 static void amdgpu_hotplug_work_func(struct work_struct *work)
     90 {
     91 	struct amdgpu_device *adev = container_of(work, struct amdgpu_device,
     92 						  hotplug_work);
     93 	struct drm_device *dev = adev->ddev;
     94 	struct drm_mode_config *mode_config = &dev->mode_config;
     95 	struct drm_connector *connector;
     96 	struct drm_connector_list_iter iter;
     97 
     98 	mutex_lock(&mode_config->mutex);
     99 	drm_connector_list_iter_begin(dev, &iter);
    100 	drm_for_each_connector_iter(connector, &iter)
    101 		amdgpu_connector_hotplug(connector);
    102 	drm_connector_list_iter_end(&iter);
    103 	mutex_unlock(&mode_config->mutex);
    104 	/* Just fire off a uevent and let userspace tell us what to do */
    105 	drm_helper_hpd_irq_event(dev);
    106 }
    107 
    108 /**
    109  * amdgpu_irq_disable_all - disable *all* interrupts
    110  *
    111  * @adev: amdgpu device pointer
    112  *
    113  * Disable all types of interrupts from all sources.
    114  */
    115 void amdgpu_irq_disable_all(struct amdgpu_device *adev)
    116 {
    117 	unsigned long irqflags;
    118 	unsigned i, j, k;
    119 	int r;
    120 
    121 	spin_lock_irqsave(&adev->irq.lock, irqflags);
    122 	for (i = 0; i < AMDGPU_IRQ_CLIENTID_MAX; ++i) {
    123 		if (!adev->irq.client[i].sources)
    124 			continue;
    125 
    126 		for (j = 0; j < AMDGPU_MAX_IRQ_SRC_ID; ++j) {
    127 			struct amdgpu_irq_src *src = adev->irq.client[i].sources[j];
    128 
    129 			if (!src || !src->funcs->set || !src->num_types)
    130 				continue;
    131 
    132 			for (k = 0; k < src->num_types; ++k) {
    133 				atomic_set(&src->enabled_types[k], 0);
    134 				r = src->funcs->set(adev, src, k,
    135 						    AMDGPU_IRQ_STATE_DISABLE);
    136 				if (r)
    137 					DRM_ERROR("error disabling interrupt (%d)\n",
    138 						  r);
    139 			}
    140 		}
    141 	}
    142 	spin_unlock_irqrestore(&adev->irq.lock, irqflags);
    143 }
    144 
    145 /**
    146  * amdgpu_irq_handler - IRQ handler
    147  *
    148  * @irq: IRQ number (unused)
    149  * @arg: pointer to DRM device
    150  *
    151  * IRQ handler for amdgpu driver (all ASICs).
    152  *
    153  * Returns:
    154  * result of handling the IRQ, as defined by &irqreturn_t
    155  */
    156 irqreturn_t amdgpu_irq_handler(int irq, void *arg)
    157 {
    158 	struct drm_device *dev = (struct drm_device *) arg;
    159 	struct amdgpu_device *adev = dev->dev_private;
    160 	irqreturn_t ret;
    161 
    162 	ret = amdgpu_ih_process(adev, &adev->irq.ih);
    163 	if (ret == IRQ_HANDLED)
    164 		pm_runtime_mark_last_busy(dev->dev);
    165 
    166 	/* For the hardware that cannot enable bif ring for both ras_controller_irq
    167          * and ras_err_evnet_athub_irq ih cookies, the driver has to poll status
    168 	 * register to check whether the interrupt is triggered or not, and properly
    169 	 * ack the interrupt if it is there
    170 	 */
    171 	if (amdgpu_ras_is_supported(adev, AMDGPU_RAS_BLOCK__PCIE_BIF)) {
    172 		if (adev->nbio.funcs &&
    173 		    adev->nbio.funcs->handle_ras_controller_intr_no_bifring)
    174 			adev->nbio.funcs->handle_ras_controller_intr_no_bifring(adev);
    175 
    176 		if (adev->nbio.funcs &&
    177 		    adev->nbio.funcs->handle_ras_err_event_athub_intr_no_bifring)
    178 			adev->nbio.funcs->handle_ras_err_event_athub_intr_no_bifring(adev);
    179 	}
    180 
    181 	return ret;
    182 }
    183 
    184 /**
    185  * amdgpu_irq_handle_ih1 - kick of processing for IH1
    186  *
    187  * @work: work structure in struct amdgpu_irq
    188  *
    189  * Kick of processing IH ring 1.
    190  */
    191 static void amdgpu_irq_handle_ih1(struct work_struct *work)
    192 {
    193 	struct amdgpu_device *adev = container_of(work, struct amdgpu_device,
    194 						  irq.ih1_work);
    195 
    196 	amdgpu_ih_process(adev, &adev->irq.ih1);
    197 }
    198 
    199 /**
    200  * amdgpu_irq_handle_ih2 - kick of processing for IH2
    201  *
    202  * @work: work structure in struct amdgpu_irq
    203  *
    204  * Kick of processing IH ring 2.
    205  */
    206 static void amdgpu_irq_handle_ih2(struct work_struct *work)
    207 {
    208 	struct amdgpu_device *adev = container_of(work, struct amdgpu_device,
    209 						  irq.ih2_work);
    210 
    211 	amdgpu_ih_process(adev, &adev->irq.ih2);
    212 }
    213 
    214 /**
    215  * amdgpu_msi_ok - check whether MSI functionality is enabled
    216  *
    217  * @adev: amdgpu device pointer (unused)
    218  *
    219  * Checks whether MSI functionality has been disabled via module parameter
    220  * (all ASICs).
    221  *
    222  * Returns:
    223  * *true* if MSIs are allowed to be enabled or *false* otherwise
    224  */
    225 static bool amdgpu_msi_ok(struct amdgpu_device *adev)
    226 {
    227 	if (amdgpu_msi == 1)
    228 		return true;
    229 	else if (amdgpu_msi == 0)
    230 		return false;
    231 
    232 	return true;
    233 }
    234 
    235 /**
    236  * amdgpu_irq_init - initialize interrupt handling
    237  *
    238  * @adev: amdgpu device pointer
    239  *
    240  * Sets up work functions for hotplug and reset interrupts, enables MSI
    241  * functionality, initializes vblank, hotplug and reset interrupt handling.
    242  *
    243  * Returns:
    244  * 0 on success or error code on failure
    245  */
    246 int amdgpu_irq_init(struct amdgpu_device *adev)
    247 {
    248 	int r = 0;
    249 
    250 	spin_lock_init(&adev->irq.lock);
    251 
    252 	/* Enable MSI if not disabled by module parameter */
    253 	adev->irq.msi_enabled = false;
    254 
    255 	if (amdgpu_msi_ok(adev)) {
    256 		int nvec = pci_msix_vec_count(adev->pdev);
    257 		unsigned int flags;
    258 
    259 		if (nvec <= 0) {
    260 			flags = PCI_IRQ_MSI;
    261 		} else {
    262 			flags = PCI_IRQ_MSI | PCI_IRQ_MSIX;
    263 		}
    264 		/* we only need one vector */
    265 		nvec = pci_alloc_irq_vectors(adev->pdev, 1, 1, flags);
    266 		if (nvec > 0) {
    267 			adev->irq.msi_enabled = true;
    268 			dev_dbg(adev->dev, "amdgpu: using MSI/MSI-X.\n");
    269 		}
    270 	}
    271 
    272 	if (!amdgpu_device_has_dc_support(adev)) {
    273 		if (!adev->enable_virtual_display)
    274 			/* Disable vblank IRQs aggressively for power-saving */
    275 			/* XXX: can this be enabled for DC? */
    276 			adev->ddev->vblank_disable_immediate = true;
    277 
    278 		r = drm_vblank_init(adev->ddev, adev->mode_info.num_crtc);
    279 		if (r)
    280 			return r;
    281 
    282 		/* Pre-DCE11 */
    283 		INIT_WORK(&adev->hotplug_work,
    284 				amdgpu_hotplug_work_func);
    285 	}
    286 
    287 	INIT_WORK(&adev->irq.ih1_work, amdgpu_irq_handle_ih1);
    288 	INIT_WORK(&adev->irq.ih2_work, amdgpu_irq_handle_ih2);
    289 
    290 	adev->irq.installed = true;
    291 	/* Use vector 0 for MSI-X */
    292 	r = drm_irq_install(adev->ddev, pci_irq_vector(adev->pdev, 0));
    293 	if (r) {
    294 		adev->irq.installed = false;
    295 		if (!amdgpu_device_has_dc_support(adev))
    296 			flush_work(&adev->hotplug_work);
    297 		return r;
    298 	}
    299 	adev->ddev->max_vblank_count = 0x00ffffff;
    300 
    301 	DRM_DEBUG("amdgpu: irq initialized.\n");
    302 	return 0;
    303 }
    304 
    305 /**
    306  * amdgpu_irq_fini - shut down interrupt handling
    307  *
    308  * @adev: amdgpu device pointer
    309  *
    310  * Tears down work functions for hotplug and reset interrupts, disables MSI
    311  * functionality, shuts down vblank, hotplug and reset interrupt handling,
    312  * turns off interrupts from all sources (all ASICs).
    313  */
    314 void amdgpu_irq_fini(struct amdgpu_device *adev)
    315 {
    316 	unsigned i, j;
    317 
    318 	if (adev->irq.installed) {
    319 		drm_irq_uninstall(adev->ddev);
    320 		adev->irq.installed = false;
    321 		if (adev->irq.msi_enabled)
    322 			pci_free_irq_vectors(adev->pdev);
    323 		if (!amdgpu_device_has_dc_support(adev))
    324 			flush_work(&adev->hotplug_work);
    325 	}
    326 
    327 	for (i = 0; i < AMDGPU_IRQ_CLIENTID_MAX; ++i) {
    328 		if (!adev->irq.client[i].sources)
    329 			continue;
    330 
    331 		for (j = 0; j < AMDGPU_MAX_IRQ_SRC_ID; ++j) {
    332 			struct amdgpu_irq_src *src = adev->irq.client[i].sources[j];
    333 
    334 			if (!src)
    335 				continue;
    336 
    337 			kfree(src->enabled_types);
    338 			src->enabled_types = NULL;
    339 			if (src->data) {
    340 				kfree(src->data);
    341 				kfree(src);
    342 				adev->irq.client[i].sources[j] = NULL;
    343 			}
    344 		}
    345 		kfree(adev->irq.client[i].sources);
    346 		adev->irq.client[i].sources = NULL;
    347 	}
    348 }
    349 
    350 /**
    351  * amdgpu_irq_add_id - register IRQ source
    352  *
    353  * @adev: amdgpu device pointer
    354  * @client_id: client id
    355  * @src_id: source id
    356  * @source: IRQ source pointer
    357  *
    358  * Registers IRQ source on a client.
    359  *
    360  * Returns:
    361  * 0 on success or error code otherwise
    362  */
    363 int amdgpu_irq_add_id(struct amdgpu_device *adev,
    364 		      unsigned client_id, unsigned src_id,
    365 		      struct amdgpu_irq_src *source)
    366 {
    367 	if (client_id >= AMDGPU_IRQ_CLIENTID_MAX)
    368 		return -EINVAL;
    369 
    370 	if (src_id >= AMDGPU_MAX_IRQ_SRC_ID)
    371 		return -EINVAL;
    372 
    373 	if (!source->funcs)
    374 		return -EINVAL;
    375 
    376 	if (!adev->irq.client[client_id].sources) {
    377 		adev->irq.client[client_id].sources =
    378 			kcalloc(AMDGPU_MAX_IRQ_SRC_ID,
    379 				sizeof(struct amdgpu_irq_src *),
    380 				GFP_KERNEL);
    381 		if (!adev->irq.client[client_id].sources)
    382 			return -ENOMEM;
    383 	}
    384 
    385 	if (adev->irq.client[client_id].sources[src_id] != NULL)
    386 		return -EINVAL;
    387 
    388 	if (source->num_types && !source->enabled_types) {
    389 		atomic_t *types;
    390 
    391 		types = kcalloc(source->num_types, sizeof(atomic_t),
    392 				GFP_KERNEL);
    393 		if (!types)
    394 			return -ENOMEM;
    395 
    396 		source->enabled_types = types;
    397 	}
    398 
    399 	adev->irq.client[client_id].sources[src_id] = source;
    400 	return 0;
    401 }
    402 
    403 /**
    404  * amdgpu_irq_dispatch - dispatch IRQ to IP blocks
    405  *
    406  * @adev: amdgpu device pointer
    407  * @ih: interrupt ring instance
    408  *
    409  * Dispatches IRQ to IP blocks.
    410  */
    411 void amdgpu_irq_dispatch(struct amdgpu_device *adev,
    412 			 struct amdgpu_ih_ring *ih)
    413 {
    414 	u32 ring_index = ih->rptr >> 2;
    415 	struct amdgpu_iv_entry entry;
    416 	unsigned client_id, src_id;
    417 	struct amdgpu_irq_src *src;
    418 	bool handled = false;
    419 	int r;
    420 
    421 	entry.iv_entry = (const uint32_t *)&ih->ring[ring_index];
    422 	amdgpu_ih_decode_iv(adev, &entry);
    423 
    424 	trace_amdgpu_iv(ih - &adev->irq.ih, &entry);
    425 
    426 	client_id = entry.client_id;
    427 	src_id = entry.src_id;
    428 
    429 	if (client_id >= AMDGPU_IRQ_CLIENTID_MAX) {
    430 		DRM_DEBUG("Invalid client_id in IV: %d\n", client_id);
    431 
    432 	} else	if (src_id >= AMDGPU_MAX_IRQ_SRC_ID) {
    433 		DRM_DEBUG("Invalid src_id in IV: %d\n", src_id);
    434 
    435 	} else if (adev->irq.virq[src_id]) {
    436 		generic_handle_irq(irq_find_mapping(adev->irq.domain, src_id));
    437 
    438 	} else if (!adev->irq.client[client_id].sources) {
    439 		DRM_DEBUG("Unregistered interrupt client_id: %d src_id: %d\n",
    440 			  client_id, src_id);
    441 
    442 	} else if ((src = adev->irq.client[client_id].sources[src_id])) {
    443 		r = src->funcs->process(adev, src, &entry);
    444 		if (r < 0)
    445 			DRM_ERROR("error processing interrupt (%d)\n", r);
    446 		else if (r)
    447 			handled = true;
    448 
    449 	} else {
    450 		DRM_DEBUG("Unhandled interrupt src_id: %d\n", src_id);
    451 	}
    452 
    453 	/* Send it to amdkfd as well if it isn't already handled */
    454 	if (!handled)
    455 		amdgpu_amdkfd_interrupt(adev, entry.iv_entry);
    456 }
    457 
    458 /**
    459  * amdgpu_irq_update - update hardware interrupt state
    460  *
    461  * @adev: amdgpu device pointer
    462  * @src: interrupt source pointer
    463  * @type: type of interrupt
    464  *
    465  * Updates interrupt state for the specific source (all ASICs).
    466  */
    467 int amdgpu_irq_update(struct amdgpu_device *adev,
    468 			     struct amdgpu_irq_src *src, unsigned type)
    469 {
    470 	unsigned long irqflags;
    471 	enum amdgpu_interrupt_state state;
    472 	int r;
    473 
    474 	spin_lock_irqsave(&adev->irq.lock, irqflags);
    475 
    476 	/* We need to determine after taking the lock, otherwise
    477 	   we might disable just enabled interrupts again */
    478 	if (amdgpu_irq_enabled(adev, src, type))
    479 		state = AMDGPU_IRQ_STATE_ENABLE;
    480 	else
    481 		state = AMDGPU_IRQ_STATE_DISABLE;
    482 
    483 	r = src->funcs->set(adev, src, type, state);
    484 	spin_unlock_irqrestore(&adev->irq.lock, irqflags);
    485 	return r;
    486 }
    487 
    488 /**
    489  * amdgpu_irq_gpu_reset_resume_helper - update interrupt states on all sources
    490  *
    491  * @adev: amdgpu device pointer
    492  *
    493  * Updates state of all types of interrupts on all sources on resume after
    494  * reset.
    495  */
    496 void amdgpu_irq_gpu_reset_resume_helper(struct amdgpu_device *adev)
    497 {
    498 	int i, j, k;
    499 
    500 	for (i = 0; i < AMDGPU_IRQ_CLIENTID_MAX; ++i) {
    501 		if (!adev->irq.client[i].sources)
    502 			continue;
    503 
    504 		for (j = 0; j < AMDGPU_MAX_IRQ_SRC_ID; ++j) {
    505 			struct amdgpu_irq_src *src = adev->irq.client[i].sources[j];
    506 
    507 			if (!src)
    508 				continue;
    509 			for (k = 0; k < src->num_types; k++)
    510 				amdgpu_irq_update(adev, src, k);
    511 		}
    512 	}
    513 }
    514 
    515 /**
    516  * amdgpu_irq_get - enable interrupt
    517  *
    518  * @adev: amdgpu device pointer
    519  * @src: interrupt source pointer
    520  * @type: type of interrupt
    521  *
    522  * Enables specified type of interrupt on the specified source (all ASICs).
    523  *
    524  * Returns:
    525  * 0 on success or error code otherwise
    526  */
    527 int amdgpu_irq_get(struct amdgpu_device *adev, struct amdgpu_irq_src *src,
    528 		   unsigned type)
    529 {
    530 	if (!adev->ddev->irq_enabled)
    531 		return -ENOENT;
    532 
    533 	if (type >= src->num_types)
    534 		return -EINVAL;
    535 
    536 	if (!src->enabled_types || !src->funcs->set)
    537 		return -EINVAL;
    538 
    539 	if (atomic_inc_return(&src->enabled_types[type]) == 1)
    540 		return amdgpu_irq_update(adev, src, type);
    541 
    542 	return 0;
    543 }
    544 
    545 /**
    546  * amdgpu_irq_put - disable interrupt
    547  *
    548  * @adev: amdgpu device pointer
    549  * @src: interrupt source pointer
    550  * @type: type of interrupt
    551  *
    552  * Enables specified type of interrupt on the specified source (all ASICs).
    553  *
    554  * Returns:
    555  * 0 on success or error code otherwise
    556  */
    557 int amdgpu_irq_put(struct amdgpu_device *adev, struct amdgpu_irq_src *src,
    558 		   unsigned type)
    559 {
    560 	if (!adev->ddev->irq_enabled)
    561 		return -ENOENT;
    562 
    563 	if (type >= src->num_types)
    564 		return -EINVAL;
    565 
    566 	if (!src->enabled_types || !src->funcs->set)
    567 		return -EINVAL;
    568 
    569 	if (atomic_dec_and_test(&src->enabled_types[type]))
    570 		return amdgpu_irq_update(adev, src, type);
    571 
    572 	return 0;
    573 }
    574 
    575 /**
    576  * amdgpu_irq_enabled - check whether interrupt is enabled or not
    577  *
    578  * @adev: amdgpu device pointer
    579  * @src: interrupt source pointer
    580  * @type: type of interrupt
    581  *
    582  * Checks whether the given type of interrupt is enabled on the given source.
    583  *
    584  * Returns:
    585  * *true* if interrupt is enabled, *false* if interrupt is disabled or on
    586  * invalid parameters
    587  */
    588 bool amdgpu_irq_enabled(struct amdgpu_device *adev, struct amdgpu_irq_src *src,
    589 			unsigned type)
    590 {
    591 	if (!adev->ddev->irq_enabled)
    592 		return false;
    593 
    594 	if (type >= src->num_types)
    595 		return false;
    596 
    597 	if (!src->enabled_types || !src->funcs->set)
    598 		return false;
    599 
    600 	return !!atomic_read(&src->enabled_types[type]);
    601 }
    602 
    603 /* XXX: Generic IRQ handling */
    604 static void amdgpu_irq_mask(struct irq_data *irqd)
    605 {
    606 	/* XXX */
    607 }
    608 
    609 static void amdgpu_irq_unmask(struct irq_data *irqd)
    610 {
    611 	/* XXX */
    612 }
    613 
    614 /* amdgpu hardware interrupt chip descriptor */
    615 static struct irq_chip amdgpu_irq_chip = {
    616 	.name = "amdgpu-ih",
    617 	.irq_mask = amdgpu_irq_mask,
    618 	.irq_unmask = amdgpu_irq_unmask,
    619 };
    620 
    621 /**
    622  * amdgpu_irqdomain_map - create mapping between virtual and hardware IRQ numbers
    623  *
    624  * @d: amdgpu IRQ domain pointer (unused)
    625  * @irq: virtual IRQ number
    626  * @hwirq: hardware irq number
    627  *
    628  * Current implementation assigns simple interrupt handler to the given virtual
    629  * IRQ.
    630  *
    631  * Returns:
    632  * 0 on success or error code otherwise
    633  */
    634 static int amdgpu_irqdomain_map(struct irq_domain *d,
    635 				unsigned int irq, irq_hw_number_t hwirq)
    636 {
    637 	if (hwirq >= AMDGPU_MAX_IRQ_SRC_ID)
    638 		return -EPERM;
    639 
    640 	irq_set_chip_and_handler(irq,
    641 				 &amdgpu_irq_chip, handle_simple_irq);
    642 	return 0;
    643 }
    644 
    645 /* Implementation of methods for amdgpu IRQ domain */
    646 static const struct irq_domain_ops amdgpu_hw_irqdomain_ops = {
    647 	.map = amdgpu_irqdomain_map,
    648 };
    649 
    650 /**
    651  * amdgpu_irq_add_domain - create a linear IRQ domain
    652  *
    653  * @adev: amdgpu device pointer
    654  *
    655  * Creates an IRQ domain for GPU interrupt sources
    656  * that may be driven by another driver (e.g., ACP).
    657  *
    658  * Returns:
    659  * 0 on success or error code otherwise
    660  */
    661 int amdgpu_irq_add_domain(struct amdgpu_device *adev)
    662 {
    663 	adev->irq.domain = irq_domain_add_linear(NULL, AMDGPU_MAX_IRQ_SRC_ID,
    664 						 &amdgpu_hw_irqdomain_ops, adev);
    665 	if (!adev->irq.domain) {
    666 		DRM_ERROR("GPU irq add domain failed\n");
    667 		return -ENODEV;
    668 	}
    669 
    670 	return 0;
    671 }
    672 
    673 /**
    674  * amdgpu_irq_remove_domain - remove the IRQ domain
    675  *
    676  * @adev: amdgpu device pointer
    677  *
    678  * Removes the IRQ domain for GPU interrupt sources
    679  * that may be driven by another driver (e.g., ACP).
    680  */
    681 void amdgpu_irq_remove_domain(struct amdgpu_device *adev)
    682 {
    683 	if (adev->irq.domain) {
    684 		irq_domain_remove(adev->irq.domain);
    685 		adev->irq.domain = NULL;
    686 	}
    687 }
    688 
    689 /**
    690  * amdgpu_irq_create_mapping - create mapping between domain Linux IRQs
    691  *
    692  * @adev: amdgpu device pointer
    693  * @src_id: IH source id
    694  *
    695  * Creates mapping between a domain IRQ (GPU IH src id) and a Linux IRQ
    696  * Use this for components that generate a GPU interrupt, but are driven
    697  * by a different driver (e.g., ACP).
    698  *
    699  * Returns:
    700  * Linux IRQ
    701  */
    702 unsigned amdgpu_irq_create_mapping(struct amdgpu_device *adev, unsigned src_id)
    703 {
    704 	adev->irq.virq[src_id] = irq_create_mapping(adev->irq.domain, src_id);
    705 
    706 	return adev->irq.virq[src_id];
    707 }
    708