STRUCT IPA(9)

🦋 struct ipa(9) — the Kernel API Manual glow-up 🦋

okay so bestie, welcome to struct ipa(9) — literally the main-character struct of the IPA subsystem, and yes, it's giving "everything you ever needed to know about an IPA instance, in one extremely long list of fields." no cap, this thing is long, but we're gonna get through it together 💖

---

✨ NAME ✨

struct ipa — IPA information 🎀 like, that's it, that's the whole vibe: it's the struct that holds the IPA info.

---

✨ SYNOPSIS ✨

here it is in all its glory, bestie — every field, exactly as written, do not touch:

struct ipa {
    struct gsi gsi;
    enum ipa_version version;
    struct device *dev;
    struct completion completion;
    struct notifier_block nb;
    void *notifier;
    struct ipa_smp2p *smp2p;
    struct ipa_power *power;
    dma_addr_t table_addr;
    __le64 *table_virt;
    u32 route_count;
    u32 modem_route_count;
    u32 filter_count;
    struct ipa_interrupt *interrupt;
    bool uc_powered;
    bool uc_loaded;
    void __iomem *reg_virt;
    const struct regs *regs;
    dma_addr_t mem_addr;
    void *mem_virt;
    u32 mem_offset;
    u32 mem_size;
    u32 mem_count;
    const struct ipa_mem *mem;
    unsigned long imem_iova;
    size_t imem_size;
    unsigned long smem_iova;
    size_t smem_size;
    dma_addr_t zero_addr;
    void *zero_virt;
    size_t zero_size;
    u32 endpoint_count;
    u32 available_count;
    unsigned long *defined;
    unsigned long *available;
    u64 filtered;
    unsigned long *set_up;
    unsigned long *enabled;
    u32 modem_tx_count;
    struct ipa_endpoint endpoint[IPA_ENDPOINT_MAX];
    struct ipa_endpoint *channel_map[GSI_CHANNEL_COUNT_MAX];
    struct ipa_endpoint *name_map[IPA_ENDPOINT_COUNT];
    bool setup_complete;
    atomic_t modem_state;
    struct net_device *modem_netdev;
    struct ipa_qmi qmi;
 };

---

✨ Members ✨

okay, field-by-field tour, no skipping, we're doing ALL of them 🫶

🌸 Core bits

• gsi — the Embedded GSI structure, tucked right in there 🪺
• version — the IPA hardware version, iykyk
• dev — the IPA device pointer
• completion — used to signal pipeline clear transfer complete ✨ (say that five times fast)
• nb — notifier block used for remoteproc SSR
• notifier — the remoteproc SSR notifier
• smp2p — SMP2P information
• power — IPA power information ⚡
• interrupt — IPA Interrupt information

🎀 Tables & counts

• table_addr — DMA address of filter/route table content
• table_virt — virtual address of filter/route table content
• route_count — total number of entries in a routing table
• modem_route_count — number of modem entries in a routing table
• filter_count — maximum number of entries in a filter table

🧚 Microcontroller vibes

• uc_powered — true if power is active by proxy for microcontroller
• uc_loaded — true after microcontroller has reported it's ready 👑

💜 Registers

• reg_virt — virtual address used for IPA register access
• regs — IPA register definitions

🍓 IPA-local memory (the whole memory saga)

• mem_addr — DMA address of IPA-local memory space
• mem_virt — virtual address of IPA-local memory space
• mem_offset — offset from mem_virt used for access to IPA memory
• mem_size — total size (bytes) of memory at mem_virt
• mem_count — number of entries in the mem array
• mem — array of IPA-local memory region descriptors

🌈 IMEM & SMEM

• imem_iova — I/O virtual address of IPA region in IMEM
• imem_size — size of IMEM region
• smem_iova — I/O virtual address of IPA region in SMEM
• smem_size — size of SMEM region

⭐ The zero-filled memory trio (say hi to the zeros)

• zero_addr — DMA address of preallocated zero-filled memory
• zero_virt — virtual address of preallocated zero-filled memory
• zero_size — size (bytes) of preallocated zero-filled memory

🦋 Endpoint bitmap era

• endpoint_count — number of defined bits in most bitmaps below
• available_count — number of defined bits in the available bitmap
• defined — bitmap of endpoints defined in config data
• available — bitmap of endpoints supported by hardware
• filtered — bitmap of endpoints that support filtering
• set_up — bitmap of endpoints that are set up for use
• enabled — bitmap of currently enabled endpoints
• modem_tx_count — number of defined modem TX endoints (yes, "endoints" — that's literally how it's spelled here, and honestly? iconic 💅)

🔥 Endpoint data & maps

• endpoint — array of endpoint information
• channel_map — mapping of GSI channel to IPA endpoint
• name_map — mapping of IPA endpoint name to IPA endpoint

🎀 State & modem stuff

• setup_complete — flag indicating whether setup stage has completed
• modem_state — state of modem (stopped, running)
• modem_netdev — network device structure used for modem
• qmi — QMI information

---

✨ SEE ALSO ✨

• Kernel file ./drivers/net/ipa/ipa.h
• ipa_setup(9)

---

bestie reminder: this is a kernel struct in a manual page, so if you're here you're already doing great 💖 go read ipa_setup(9) next, it's literally the natural sequel ✨

---

and that's the whole page, fr fr 🫶 this little love letter lives in ./drivers/net/ipa and it's dated October 2026 — go off, you absolute kernel legend 👑💅