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

source code of linux/drivers/gpu/drm/amd/amdgpu/amdgpu_irq.c