drivers/irqchip/irq-gic-v5.c
Source file repositories/reference/linux-study-clean/drivers/irqchip/irq-gic-v5.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/irqchip/irq-gic-v5.c- Extension
.c- Size
- 31668 bytes
- Lines
- 1268
- Domain
- Driver Families
- Bucket
- drivers/irqchip
- Inferred role
- Driver Families: implementation source
- Status
- source implementation candidate
Why This File Exists
Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/acpi_iort.hlinux/cpuhotplug.hlinux/idr.hlinux/irqdomain.hlinux/slab.hlinux/wordpart.hlinux/irqchip.hlinux/irqchip/arm-gic-v5.hlinux/irqchip/arm-vgic-info.hasm/cpufeature.hasm/exception.h
Detected Declarations
enum ppi_regfunction gicv5_cpuif_has_gciefunction gicv5_init_lpisfunction gicv5_deinit_lpisfunction alloc_lpifunction release_lpifunction gicv5_ppi_priority_initfunction gicv5_hwirq_initfunction gicv5_ppi_irq_maskfunction gicv5_iri_irq_maskfunction gicv5_spi_irq_maskfunction gicv5_lpi_irq_maskfunction gicv5_ppi_irq_unmaskfunction gicv5_iri_irq_unmaskfunction gicv5_spi_irq_unmaskfunction gicv5_lpi_irq_unmaskfunction gicv5_hwirq_eoifunction gicv5_ppi_irq_eoifunction gicv5_spi_irq_eoifunction gicv5_lpi_irq_eoifunction gicv5_iri_irq_set_affinityfunction gicv5_spi_irq_set_affinityfunction gicv5_lpi_irq_set_affinityfunction read_ppi_sysreg_sfunction write_ppi_sysreg_sfunction gicv5_ppi_irq_get_irqchip_statefunction gicv5_iri_irq_get_irqchip_statefunction gicv5_spi_irq_get_irqchip_statefunction gicv5_lpi_irq_get_irqchip_statefunction gicv5_ppi_irq_set_irqchip_statefunction gicv5_iri_irq_write_pending_statefunction gicv5_spi_irq_write_pending_statefunction gicv5_lpi_irq_write_pending_statefunction gicv5_spi_irq_set_irqchip_statefunction gicv5_lpi_irq_set_irqchip_statefunction gicv5_spi_irq_retriggerfunction gicv5_lpi_irq_retriggerfunction gicv5_ipi_send_singlefunction gicv5_ppi_irq_is_levelfunction gicv5_ppi_irq_set_typefunction gicv5_ppi_irq_set_vcpu_affinityfunction gicv5_irq_domain_translatefunction gicv5_irq_ppi_domain_translatefunction gicv5_irq_ppi_domain_allocfunction gicv5_irq_domain_freefunction gicv5_irq_ppi_domain_selectfunction gicv5_irq_spi_domain_translatefunction gicv5_irq_spi_domain_alloc
Annotated Snippet
if (set) {
if (irq < 64)
write_sysreg_s(bit, SYS_ICC_PPI_SPENDR0_EL1);
else
write_sysreg_s(bit, SYS_ICC_PPI_SPENDR1_EL1);
} else {
if (irq < 64)
write_sysreg_s(bit, SYS_ICC_PPI_CPENDR0_EL1);
else
write_sysreg_s(bit, SYS_ICC_PPI_CPENDR1_EL1);
}
return;
case PPI_ACTIVE:
if (set) {
if (irq < 64)
write_sysreg_s(bit, SYS_ICC_PPI_SACTIVER0_EL1);
else
write_sysreg_s(bit, SYS_ICC_PPI_SACTIVER1_EL1);
} else {
if (irq < 64)
write_sysreg_s(bit, SYS_ICC_PPI_CACTIVER0_EL1);
else
write_sysreg_s(bit, SYS_ICC_PPI_CACTIVER1_EL1);
}
return;
default:
BUILD_BUG_ON(1);
}
}
static int gicv5_ppi_irq_get_irqchip_state(struct irq_data *d,
enum irqchip_irq_state which,
bool *state)
{
u64 hwirq_id_bit = BIT_ULL(d->hwirq % 64);
switch (which) {
case IRQCHIP_STATE_PENDING:
*state = !!(read_ppi_sysreg_s(d->hwirq, PPI_PENDING) & hwirq_id_bit);
return 0;
case IRQCHIP_STATE_ACTIVE:
*state = !!(read_ppi_sysreg_s(d->hwirq, PPI_ACTIVE) & hwirq_id_bit);
return 0;
default:
pr_debug("Unexpected PPI irqchip state\n");
return -EINVAL;
}
}
static int gicv5_iri_irq_get_irqchip_state(struct irq_data *d,
enum irqchip_irq_state which,
bool *state, u8 hwirq_type)
{
u64 icsr, cdrcfg;
cdrcfg = d->hwirq | FIELD_PREP(GICV5_GIC_CDRCFG_TYPE_MASK, hwirq_type);
gic_insn(cdrcfg, CDRCFG);
isb();
icsr = read_sysreg_s(SYS_ICC_ICSR_EL1);
if (FIELD_GET(ICC_ICSR_EL1_F, icsr)) {
pr_err("ICSR_EL1 is invalid\n");
return -EINVAL;
}
switch (which) {
case IRQCHIP_STATE_PENDING:
*state = !!(FIELD_GET(ICC_ICSR_EL1_Pending, icsr));
return 0;
case IRQCHIP_STATE_ACTIVE:
*state = !!(FIELD_GET(ICC_ICSR_EL1_Active, icsr));
return 0;
default:
pr_debug("Unexpected irqchip_irq_state\n");
return -EINVAL;
}
}
static int gicv5_spi_irq_get_irqchip_state(struct irq_data *d,
enum irqchip_irq_state which,
bool *state)
{
return gicv5_iri_irq_get_irqchip_state(d, which, state,
GICV5_HWIRQ_TYPE_SPI);
}
static int gicv5_lpi_irq_get_irqchip_state(struct irq_data *d,
Annotation
- Immediate include surface: `linux/acpi_iort.h`, `linux/cpuhotplug.h`, `linux/idr.h`, `linux/irqdomain.h`, `linux/slab.h`, `linux/wordpart.h`, `linux/irqchip.h`, `linux/irqchip/arm-gic-v5.h`.
- Detected declarations: `enum ppi_reg`, `function gicv5_cpuif_has_gcie`, `function gicv5_init_lpis`, `function gicv5_deinit_lpis`, `function alloc_lpi`, `function release_lpi`, `function gicv5_ppi_priority_init`, `function gicv5_hwirq_init`, `function gicv5_ppi_irq_mask`, `function gicv5_iri_irq_mask`.
- Atlas domain: Driver Families / drivers/irqchip.
- Implementation status: source implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.