STRUCT TSENS_PRIV(9)

💅 struct tsens_priv(9)

okay so this is a page straight out of the Kernel API Manual, and bestie, we are about to get so cozy with it. ✨

🎀 NAME

struct tsens_priv — the private data for each instance of the tsens IP 🫶

like, every single tsens instance gets its own lil' bundle of secrets and we're holding all of them right here. no cap.

🌸 SYNOPSIS

struct tsens_priv {
    struct device                   *dev;
    u32 num_sensors;
    struct regmap                   *tm_map;
    struct regmap                   *srot_map;
    u32 tm_offset;
    spinlock_t ul_lock;
    struct regmap_field             *rf[MAX_REGFIELDS];
    struct tsens_context            ctx;
    struct tsens_features           *feat;
    const struct reg_field          *fields;
    const struct tsens_ops          *ops;
    struct dentry                   *debug_root;
    struct dentry                   *debug;
    int uplow_irq;
    int crit_irq;
    int combined_irq;
    struct tsens_sensor             sensor[];
};

look at her. the struct of all time. 💜

---

🦋 Members

okay so member by member, here we go, don't scroll past, i'm literally explaining each one:

• dev — pointer to struct device. that's the device she belongs to, her home base fr.
• num_sensors — number of sensors enabled on this device. counting them like a little inventory 🍓
• tm_map — pointer to the TM register address space.
• srot_map — pointer to the SROT register address space.
• tm_offset — this one deals with old device trees that don't address the TM and SROT address space separately. legacy support, iconic behavior honestly.
• ul_lock — the lock while processing upper/lower threshold interrupts. she's keeping things from stepping on each other 💅
• rf — array of regmap_fields used to store the value of the field. it's an array, and it's literally MAX_REGFIELDS long, and yes that's a macro you have to just trust.
• ctx — the registers to be saved and restored during suspend/resume. nap time preservation 🧚
• feat — features of the IP. her personality traits, basically.
• fields — bitfield locations. where things live inside the bits, iykyk.
• ops — pointer to the list of callbacks supported by this device. all her little functions she can do 🔥
• debug_root — pointer to the debugfs dentry for all tsens.
• debug — pointer to the debugfs dentry for the tsens controller. yes these two are different, do not mix them up, i saw that.
• uplow_irq — the IRQ number for uplow (upper/lower) threshold interrupts.
• crit_irq — the IRQ number for critical threshold interrupts. critical, as in, girl, this one matters.
• combined_irq — the IRQ number for combined threshold interrupts. the two-for-one situation.
• sensor — list of sensors attached to this device. the actual cast of characters 👑

ngl the sensor[] at the end is a flexible array member, which is exactly the kind of main character energy this struct is giving. ✨

---

🌈 SEE ALSO

sibling pages, the whole squad, go read them:

• the Kernel file ./drivers/thermal/qcom/tsens.h
• struct tsens_sensor(9)
• struct tsens_ops(9)
• struct tsens_features(9)
• struct tsens_plat_data(9)
• struct tsens_context(9)
• struct tsens_single_value(9)
• struct tsens_legacy_calibration_format(9)

---

💖 and that's the page!! sourced from ./drivers/thermal/qcom, dated October 2026, living in the Kernel API Manual — go off, bestie, you now know the whole struct. periodt. 🎀🦋💅