drivers/irqchip/irq-loongarch-ir.c
Source file repositories/reference/linux-study-clean/drivers/irqchip/irq-loongarch-ir.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/irqchip/irq-loongarch-ir.c- Extension
.c- Size
- 13176 bytes
- Lines
- 538
- 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.
- 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/init.hlinux/interrupt.hlinux/io-64-nonatomic-lo-hi.hlinux/irq.hlinux/irqchip.hlinux/irqchip/irq-msi-lib.hlinux/irqdomain.hlinux/kernel.hlinux/msi.hlinux/spinlock.hasm/irq.hasm/loongarch.hasm/loongson.hasm/numa.hasm/setup.hirq-loongson.h
Detected Declarations
struct redirect_entrystruct redirect_cmdstruct redirect_gpidstruct redirect_tablestruct redirect_queuestruct redirect_descstruct redirect_itemfunction redirect_read_reg32function redirect_write_reg32function redirect_write_reg64function invalid_queue_is_fullfunction invalid_enqueuefunction irde_invalidate_entryfunction redirect_table_allocfunction redirect_table_freefunction redirect_domain_prepare_entryfunction redirect_free_resourcesfunction redirect_set_affinityfunction redirect_compose_msi_msgfunction redirect_domain_allocfunction redirect_domain_freefunction redirect_table_initfunction redirect_queue_initfunction redirect_irde_cfgfunction redirect_irde_freefunction redirect_irde_initfunction pch_msi_parse_madtfunction acpi_cascade_irqdomain_initfunction redirect_acpi_initfunction for_each_node_mask
Annotated Snippet
struct redirect_entry {
struct {
u64 valid : 1,
res1 : 5,
gpid : 42,
res2 : 8,
vector : 8;
} lo;
u64 hi;
};
#define IRD_ENTRY_SIZE sizeof(struct redirect_entry)
#define IRD_ENTRIES SZ_64K
#define IRD_TABLE_PAGE_ORDER get_order(IRD_ENTRIES * IRD_ENTRY_SIZE)
struct redirect_cmd {
union {
u64 cmd_info;
struct {
u64 res1 : 4,
type : 1,
need_notice : 1,
pad1 : 2,
index : 16,
pad2 : 40;
} index;
};
u64 notice_addr;
};
#define IRD_CMD_SIZE sizeof(struct redirect_cmd)
#define INV_QUEUE_SIZE SZ_4K
#define INV_QUEUE_PAGE_ORDER get_order(INV_QUEUE_SIZE * IRD_CMD_SIZE)
struct redirect_gpid {
u64 pir[4]; /* Pending interrupt requested */
u8 en : 1, /* Doorbell */
res1 : 7;
u8 irqnum;
u16 res2;
u32 dstcpu;
u32 rsvd[6];
};
struct redirect_table {
struct redirect_entry *table;
unsigned long *bitmap;
raw_spinlock_t lock;
};
struct redirect_queue {
struct redirect_cmd *cmd_base;
int head;
int tail;
raw_spinlock_t lock;
};
struct redirect_desc {
struct redirect_table ird_table;
struct redirect_queue inv_queue;
int node;
};
struct redirect_item {
int index;
struct redirect_desc *irde;
struct redirect_gpid *gpid;
};
static struct irq_domain *redirect_domain;
static struct redirect_desc redirect_descs[MAX_IR_ENGINES];
static phys_addr_t msi_base_addr;
static phys_addr_t redirect_reg_base = LOONGSON_REG_BASE;
#ifdef CONFIG_32BIT
#define REDIRECT_REG(reg, node) \
((void __iomem *)(IO_BASE | redirect_reg_base | (reg)))
#else
#define REDIRECT_REG(reg, node) \
((void __iomem *)(IO_BASE | redirect_reg_base | (u64)(node) << NODE_ADDRSPACE_SHIFT | (reg)))
#endif
static inline u32 redirect_read_reg32(u32 node, u32 reg)
{
return readl(REDIRECT_REG(reg, node));
Annotation
- Immediate include surface: `linux/init.h`, `linux/interrupt.h`, `linux/io-64-nonatomic-lo-hi.h`, `linux/irq.h`, `linux/irqchip.h`, `linux/irqchip/irq-msi-lib.h`, `linux/irqdomain.h`, `linux/kernel.h`.
- Detected declarations: `struct redirect_entry`, `struct redirect_cmd`, `struct redirect_gpid`, `struct redirect_table`, `struct redirect_queue`, `struct redirect_desc`, `struct redirect_item`, `function redirect_read_reg32`, `function redirect_write_reg32`, `function redirect_write_reg64`.
- 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.
- 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.