drivers/irqchip/irq-gic-v5-irs.c
Source file repositories/reference/linux-study-clean/drivers/irqchip/irq-gic-v5-irs.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/irqchip/irq-gic-v5-irs.c- Extension
.c- Size
- 25540 bytes
- Lines
- 969
- 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.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- Allocates kernel memory; connect allocation flags and lifetime to context constraints.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/acpi.hlinux/kmemleak.hlinux/log2.hlinux/of.hlinux/of_address.hlinux/irqchip.hlinux/irqchip/arm-gic-v5.h
Detected Declarations
struct iaffid_entryfunction irs_readl_relaxedfunction irs_writel_relaxedfunction irs_readq_relaxedfunction irs_writeq_relaxedfunction waitfunction gicv5_irs_init_ist_linearfunction gicv5_irs_init_ist_two_levelfunction gicv5_irs_iste_allocfunction sizefunction gicv5_irs_init_istfunction tablesfunction gicv5_irs_cpu_to_iaffidfunction list_for_each_entryfunction gicv5_irs_wait_for_spi_opfunction gicv5_irs_wait_for_irs_pefunction gicv5_irs_wait_for_pe_selrfunction gicv5_irs_wait_for_pe_cr0function gicv5_spi_irq_set_typefunction gicv5_irs_wait_for_idlefunction gicv5_irs_syncrfunction gicv5_irs_register_cpufunction gicv5_irs_init_basesfunction gicv5_irs_of_init_affinityfunction irs_setup_pri_bitsfunction gicv5_irs_initfunction propertiesfunction gicv5_irs_of_initfunction gicv5_irs_removefunction list_for_each_entry_safefunction gicv5_irs_enablefunction gicv5_irs_its_probefunction gicv5_irs_of_probefunction for_each_available_child_of_nodefunction gic_acpi_parse_iaffidfunction gicv5_irs_acpi_init_affinityfunction gic_request_regionfunction gic_acpi_parse_madt_irsfunction gicv5_irs_acpi_probe
Annotated Snippet
struct iaffid_entry {
u16 iaffid;
bool valid;
};
static DEFINE_PER_CPU(struct iaffid_entry, cpu_iaffid);
int gicv5_irs_cpu_to_iaffid(int cpuid, u16 *iaffid)
{
if (!per_cpu(cpu_iaffid, cpuid).valid) {
pr_err("IAFFID for CPU %d has not been initialised\n", cpuid);
return -ENODEV;
}
*iaffid = per_cpu(cpu_iaffid, cpuid).iaffid;
return 0;
}
struct gicv5_irs_chip_data *gicv5_irs_lookup_by_spi_id(u32 spi_id)
{
struct gicv5_irs_chip_data *irs_data;
u32 min, max;
list_for_each_entry(irs_data, &irs_nodes, entry) {
if (!irs_data->spi_range)
continue;
min = irs_data->spi_min;
max = irs_data->spi_min + irs_data->spi_range - 1;
if (spi_id >= min && spi_id <= max)
return irs_data;
}
return NULL;
}
static int gicv5_irs_wait_for_spi_op(struct gicv5_irs_chip_data *irs_data)
{
u32 statusr;
int ret;
ret = gicv5_wait_for_op_atomic(irs_data->irs_base, GICV5_IRS_SPI_STATUSR,
GICV5_IRS_SPI_STATUSR_IDLE, &statusr);
if (ret)
return ret;
return !!FIELD_GET(GICV5_IRS_SPI_STATUSR_V, statusr) ? 0 : -EIO;
}
static int gicv5_irs_wait_for_irs_pe(struct gicv5_irs_chip_data *irs_data,
bool selr)
{
bool valid = true;
u32 statusr;
int ret;
ret = gicv5_wait_for_op_atomic(irs_data->irs_base, GICV5_IRS_PE_STATUSR,
GICV5_IRS_PE_STATUSR_IDLE, &statusr);
if (ret)
return ret;
if (selr)
valid = !!FIELD_GET(GICV5_IRS_PE_STATUSR_V, statusr);
return valid ? 0 : -EIO;
}
static int gicv5_irs_wait_for_pe_selr(struct gicv5_irs_chip_data *irs_data)
{
return gicv5_irs_wait_for_irs_pe(irs_data, true);
}
static int gicv5_irs_wait_for_pe_cr0(struct gicv5_irs_chip_data *irs_data)
{
return gicv5_irs_wait_for_irs_pe(irs_data, false);
}
int gicv5_spi_irq_set_type(struct irq_data *d, unsigned int type)
{
struct gicv5_irs_chip_data *irs_data = d->chip_data;
u32 selr, cfgr;
bool level;
int ret;
/*
* There is no distinction between HIGH/LOW for level IRQs
* and RISING/FALLING for edge IRQs in the architecture,
* hence consider them equivalent.
*/
Annotation
- Immediate include surface: `linux/acpi.h`, `linux/kmemleak.h`, `linux/log2.h`, `linux/of.h`, `linux/of_address.h`, `linux/irqchip.h`, `linux/irqchip/arm-gic-v5.h`.
- Detected declarations: `struct iaffid_entry`, `function irs_readl_relaxed`, `function irs_writel_relaxed`, `function irs_readq_relaxed`, `function irs_writeq_relaxed`, `function wait`, `function gicv5_irs_init_ist_linear`, `function gicv5_irs_init_ist_two_level`, `function gicv5_irs_iste_alloc`, `function size`.
- Atlas domain: Driver Families / drivers/irqchip.
- Implementation status: source implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
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.