STRUCT TCS_GROUP(9)

✨ struct tcs_group(9) ✨

okay so bestie, welcome to the Kernel API Manual 💖 you're literally about to meet struct tcs_group — a whole squad of Trigger Command Sets (TCS) that exist for one reason: to send state requests to the controller. group chat energy, but make it hardware 🎀

---

🌸 NAME 🌸

struct tcs_group — a group of Trigger Command Sets (TCS) that you send state requests to the controller with 🫶

---

✨ SYNOPSIS ✨

struct tcs_group {
    struct rsc_drv *drv;
    int type;
    u32 mask;
    u32 offset;
    int num_tcs;
    int ncpt;
    const struct tcs_request *req[MAX_TCS_PER_TYPE];
    unsigned long slots[BITS_TO_LONGS( MAX_TCS_SLOTS)];
};

---

🦋 Members 🦋

like, every single field, no skipping, iykyk 💅

• drv — The controller. the main character, honestly 👑
• type — type of the TCS in this group — active, sleep, or wake. pick your vibe ✨
• mask — mask of the TCSes relative to all the TCSes in the RSC.
• offset — start of the TCS group relative to the TCSes in the RSC.
• num_tcs — how many TCSes live in this type. the headcount 🍓
• ncpt — number of commands in each TCS.
• req — the requests that get sent from the TCS; only used for ACTIVE_ONLY transfers (tho it could be on a wake/sleep TCS if we are borrowing it for an ACTIVE_ONLY transfer 👀). The whole choreography is:
  • Start: grab drv->lock, set req, set tcs_in_use, drop drv->lock, trigger
  • End: get irq, access req, grab drv->lock, clear tcs_in_use, drop drv->lock

literally a whole routine, respect the lock discipline fr fr 🔥

• slots — indicates which of cmd_addr are occupied; only used for SLEEP / WAKE TCSs. things are tightly packed in the case that (ncpt < MAX_CMDS_PER_TCS). like, if ncpt = 2 and MAX_CMDS_PER_TCS = 16 then bit[2] = the first bit in the 2nd TCS. no wasted space, we love a compact queen 💅

ngl the req and slots fields both have conditions on when they're used, so pls don't just assume they're always live — read the vibes (and the field) first 🙈

---

💜 SEE ALSO 💜

Kernel file ./drivers/soc/qcom/rpmh-internal.h, plus the besties: struct rpmh_request(9), struct rpmh_ctrlr(9), struct rsc_drv(9) 🌈

---

and that's the whole page, bestie 🧚 this one came from ./drivers/soc/qcom and it's dated October 2026, filed under struct tcs_group(9) — go forth and slay your state requests 💖🔥👑