drivers/irqchip/irq-apple-aic.c
Source file repositories/reference/linux-study-clean/drivers/irqchip/irq-apple-aic.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/irqchip/irq-apple-aic.c- Extension
.c- Size
- 29815 bytes
- Lines
- 1137
- 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.
- Touches IRQ or DMA behavior; this matters for the representative real-device path.
- 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/bits.hlinux/bitfield.hlinux/cpuhotplug.hlinux/io.hlinux/irqchip.hlinux/irqchip/arm-vgic-info.hlinux/irqdomain.hlinux/jump_label.hlinux/limits.hlinux/of_address.hlinux/slab.hasm/apple_m1_pmu.hasm/cputype.hasm/exception.hasm/sysreg.hasm/virt.hdt-bindings/interrupt-controller/apple-aic.h
Detected Declarations
struct aic_infostruct aic_irq_chipenum fiq_hwirqfunction aic_ic_readfunction aic_ic_writefunction aic_irq_maskfunction aic_irq_unmaskfunction aic_irq_eoifunction aic_handle_irqfunction read_sysreg_sfunction aic_irq_set_affinityfunction aic_irq_set_typefunction aic_fiq_get_idxfunction aic_fiq_set_maskfunction aic_fiq_clear_maskfunction aic_fiq_maskfunction aic_fiq_unmaskfunction aic_fiq_eoifunction aic_handle_fiqfunction aic_fiq_set_typefunction aic_irq_domain_mapfunction aic_irq_get_fwspec_infofunction aic_irq_domain_translatefunction aic_irq_domain_allocfunction aic_irq_domain_freefunction aic_ipi_send_fastfunction aic_handle_ipifunction aic_ipi_send_singlefunction aic_init_smpfunction aic_init_cpufunction build_fiq_affinityfunction aic_of_ic_init
Annotated Snippet
struct aic_info {
int version;
/* Register offsets */
u32 event;
u32 target_cpu;
u32 irq_cfg;
u32 sw_set;
u32 sw_clr;
u32 mask_set;
u32 mask_clr;
u32 die_stride;
/* Features */
bool fast_ipi;
bool local_fast_ipi;
};
static const struct aic_info aic1_info __initconst = {
.version = 1,
.event = AIC_EVENT,
.target_cpu = AIC_TARGET_CPU,
};
static const struct aic_info aic1_fipi_info __initconst = {
.version = 1,
.event = AIC_EVENT,
.target_cpu = AIC_TARGET_CPU,
.fast_ipi = true,
};
static const struct aic_info aic1_local_fipi_info __initconst = {
.version = 1,
.event = AIC_EVENT,
.target_cpu = AIC_TARGET_CPU,
.fast_ipi = true,
.local_fast_ipi = true,
};
static const struct aic_info aic2_info __initconst = {
.version = 2,
.irq_cfg = AIC2_IRQ_CFG,
.fast_ipi = true,
.local_fast_ipi = true,
};
static const struct aic_info aic3_info __initconst = {
.version = 3,
.irq_cfg = AIC3_IRQ_CFG,
.fast_ipi = true,
.local_fast_ipi = true,
};
static const struct of_device_id aic_info_match[] = {
{
.compatible = "apple,t8103-aic",
.data = &aic1_local_fipi_info,
},
{
.compatible = "apple,t8015-aic",
.data = &aic1_fipi_info,
},
{
.compatible = "apple,aic",
.data = &aic1_info,
},
{
.compatible = "apple,aic2",
.data = &aic2_info,
},
{
.compatible = "apple,t8122-aic3",
.data = &aic3_info,
},
{}
};
struct aic_irq_chip {
void __iomem *base;
void __iomem *event;
Annotation
- Immediate include surface: `linux/bits.h`, `linux/bitfield.h`, `linux/cpuhotplug.h`, `linux/io.h`, `linux/irqchip.h`, `linux/irqchip/arm-vgic-info.h`, `linux/irqdomain.h`, `linux/jump_label.h`.
- Detected declarations: `struct aic_info`, `struct aic_irq_chip`, `enum fiq_hwirq`, `function aic_ic_read`, `function aic_ic_write`, `function aic_irq_mask`, `function aic_irq_unmask`, `function aic_irq_eoi`, `function aic_handle_irq`, `function read_sysreg_s`.
- Atlas domain: Driver Families / drivers/irqchip.
- Implementation status: source implementation candidate.
- IRQ or DMA behavior appears here, which is relevant to the selected PCIe/NVMe device path.
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.