STRUCT XGENE_CLK_PMD(9)

✨ struct xgene_clk_pmd — PMD clock ✨

okay bestie, so this is page struct xgene_clk_pmd(9) from the Kernel API Manual and honestly? it's giving "tiny struct, big responsibilities" 💅 she's just a little clock descriptor for the PMD (phase/frac divider thingy) on X-Gene, and she wants you to know every single one of her fields. let's get into it 🫶

---

🌸 NAME 🌸

struct xgene_clk_pmd — the PMD clock 💖 like, literally a struct that describes a PMD clock. no notes.

---

🎀 SYNOPSIS 🎀

struct xgene_clk_pmd {
    struct clk_hw   hw;
    void __iomem    *reg;
    u8 shift;
    u32 mask;
    u64 denom;
    u32 flags;
    spinlock_t *lock;
 };

look at her. seven fields. immaculate. 🔥

---

💜 MEMBERS 💜

• hw — the handle that sits between the common clock interfaces and the hardware-specific ones 🌈 think of it as her little passport between two worlds, iykyk.
• reg — the register that contains the fractional scale multiplier (the scaler) 📍 yes she's void __iomem *, yes she's memory-mapped, yes we stan.
• shift — the shift to the unit bit field. u8. she's small but she moves things. ✨
• mask — the mask to the unit bit field. u32. she's the vibe check that keeps only the bits that matter 💅
• denom — the 1/denominator unit. u64, so she's got range 💀
• flags — here's the interesting one, bestie, so pay attention 🙈

XGENE_CLK_PMD_SCALE_INVERTED — by default the scaler is the value read from the register plus one. so like:

• 0 → (0 + 1) / denom
• 1 → (1 + 1) / denom
• …and etc., you get the pattern, periodt 🔥

but if this flag is set, she flips the whole thing:

• 0 → (denom - 0) / denom
• 1 → (denom - 1) / denom
• …and etc. 🦋

same math, inverted energy. main character flag behaviour, no cap.

• lock — the register lock. spinlock_t *. she keeps everyone from touching the registers at the same time 🎀 respectful. collaborative. iconic.

---

👑 SEE ALSO 👑

• the Kernel file ./drivers/clk/clk-xgene.c — go read her home, that's where the whole story lives 🧚

---

and that's the page, bestie! 🍓 go slay some clock registration.

💖 written from source ./drivers/clk, dated October 2026, and yes the footer said struct xgene_clk_pmd(9) again because she loves a dramatic re-entrance ✨ mwah 💋