STRUCT ASPEED_PCIE(9)

✨ struct aspeed_pcie(9) ✨

okay so bestie, this is from the Kernel API Manual and it's literally the whole vibe of the Aspeed PCIe root complex (RC) — like, all the info it keeps about itself. no cap, every field here is load-bearing 💅

---

💖 NAME 💖

struct aspeed_pcie — PCIe RC information 🎀

---

🌸 SYNOPSIS 🌸

struct aspeed_pcie {
    struct pci_host_bridge *host;
    struct device *dev;
    void __iomem *reg;
    struct regmap *ahbc;
    struct regmap *cfg;
    const struct aspeed_pcie_rc_platform *platform;
    struct list_head ports;
    u8 tx_tag;
    u8 root_bus_nr;
    struct reset_control *h2xrst;
    struct irq_domain *intx_domain;
    struct irq_domain *msi_domain;
    struct mutex lock;
    unsigned long msi_irq_in_use[BITS_TO_LONGS( MAX_MSI_HOST_IRQS)];
    bool clear_msi_twice;
 };

like, that's the whole struct, copied exactly, no edits from me, i promise 🫶 (and yes, that [BITS_TO_LONGS( MAX_MSI_HOST_IRQS)] spacing is how it was written, we don't touch it)

---

🦋 Members 🦋

okay so going field by field, main character energy each one:

• host — pointer to the PCIe host bridge 👑
• dev — pointer to the device structure
• reg — PCIe host register base address
• ahbc — pointer to AHHC register map
• cfg — pointer to Aspeed PCIe configuration register map
• platform — platform specific information
• ports — list of PCIe ports
• tx_tag — current TX tag for the port
• root_bus_nr — bus number of the host bridge
• h2xrst — pointer to H2X reset control ✨
• intx_domain — IRQ domain for INTx interrupts
• msi_domain — IRQ domain for MSI interrupts
• lock — mutex to protect MSI bitmap variable 🔒
• msi_irq_in_use — bitmap to track used MSI host IRQs
• clear_msi_twice — AST2700 workaround to clear MSI status twice 💀

not me pointing out that clear_msi_twice is literally a workaround — it's for AST2700 and it clears the MSI status twice. that's the whole bit. icon.

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/pci/controller/pcie-aspeed.c struct aspeed_pcie_port(9), struct aspeed_pcie_rc_platform(9) 🧚

---

⭐ the sign-off ⭐

this lil page came from ./drivers/pci/controller and it's dated October 2026, and the whole thing is filed under struct aspeed_pcie(9) — slay, go read the driver bestie, ily, bye 💜🍓