STRUCT SPMI_PMIC_ARB_BUS(9)

💅 struct spmi_pmic_arb_bus(9)

okay so bestie, welcome to the Kernel API Manual — today's main character is struct spmi_pmic_arb_bus, the SPMI PMIC Arbiter Bus object. yes it's a struct, yes it's iconic, no you cannot skip it 🫶

---

✨ NAME ✨

struct spmi_pmic_arb_bus — the SPMI PMIC Arbiter Bus object, fr fr 🌸

---

🎀 SYNOPSIS 🎀

like, here's the whole vibe, character for character, do not touch:

struct spmi_pmic_arb_bus {
    struct spmi_pmic_arb    *pmic_arb;
    struct irq_domain       *domain;
    void __iomem            *intr;
    void __iomem            *cnfg;
    void __iomem            *apid_owner;
    struct spmi_controller  *spmic;
    raw_spinlock_t lock;
    u16 base_apid;
    int apid_count;
    u32 *mapping_table;
    unsigned long mapping_table_valid[BITS_TO_LONGS(
PMIC_ARB_MAX_PERIPHS)];
    u16 *ppid_to_apid;
    u16 last_apid;
    struct apid_data        *apid_data;
    u16 min_apid;
    u16 max_apid;
    int irq;
    u8 id;
 };

she's got range, she's got pointers, she's got a bitmap. periodt 💅

---

🌈 Members 🌈

time for the member-by-member breakdown, iykyk — every single one, no skipping 🔥

• pmic_arb — the SPMI PMIC Arbiter that this bus belongs to. like, her home base 💖
• domain — the irq domain object for the PMIC IRQ domain ✨
• intr — address of the SPMI interrupt control registers. yes, an address, and yes it's void __iomem 🎀
• cnfg — address of the PMIC Arbiter configuration registers 🦋
• apid_owner — on v8: address of the APID owner mapping table registers 👑
• spmic — the spmi controller registered for this bus 🌸
• lock — lock to synchronize accesses. raw_spinlock_t, no cap, she's keeping things orderly 💅
• base_apid — on v7 and v8: minimum APID associated with the particular SPMI bus instance ⭐
• apid_count — on v5, v7 and v8: number of APIDs associated with the particular SPMI bus instance 🌟
• mapping_table — in-memory copy of the PPID -> APID mapping table 🧚
• mapping_table_valid — bitmap containing valid-only periphs ✅
• ppid_to_apid — in-memory copy of the PPID -> APID mapping table (yes bestie, this is a second in-memory copy of the PPID -> APID mapping table, that's literally what it says, i don't make the rules 😭)
• last_apid — Highest value APID in use 🔥
• apid_data — Table of data for all APIDs 🍓
• min_apid — minimum APID (used for bounding IRQ search) 🔍
• max_apid — maximum APID 💜
• irq — the PMIC ARB interrupt 🙈
• id — unique ID of the bus, her little signature 🎀

ngl the base_apid / apid_count version tags? lowkey important. v5, v7, v8 are doing different things and the docs said what they said, so i'm passing it along verbatim 💀

---

🦋 SEE ALSO 🦋

go read these next, bestie, they're all in the kernel file ./drivers/spmi/spmi-pmic-arb.c:

• struct spmi_pmic_arb(9)
• struct pmic_arb_ver_ops(9)
• pmic_arb_read_data(9)
• pmic_arb_write_data(9)

---

and that's the page!! 💖 this little beauty lives in ./drivers/spmi, dated October 2026, and it's filed under struct spmi_pmic_arb_bus(9) in the Kernel API Manual. slay, go read some C 🧚✨🎀