STRUCT SYSMON(9)

💖 struct sysmon(9) 💖

okay so bestie, welcome to the kernel API manual for struct sysmon — that's the driver data for Versal SysMon, no cap. it's a small struct but she's doing a LOT of work, and we're gonna go through every single field together. grab a boba, this is gonna be cute 🧋✨

✨ SYNOPSIS ✨

bestie. look at her. iconic honestly:

struct sysmon {
    struct regmap *regmap;
    struct mutex lock;
    spinlock_t irq_lock;
    unsigned int masked_temp;
    unsigned int temp_mask;
    int temp_hysteresis;
    struct delayed_work sysmon_unmask_work;
    unsigned int temp_oversampling;
    unsigned int supply_oversampling;
 };

okay literally framing this. anyway, let's meet the members 🎀

🧚 Members 🧚

• regmap — the register map for hardware access. she's the plug that gets us into the silicon, fr fr 💅
• lock — a mutex that protects read-modify-write sequences on threshold registers and cached state that spans multiple regmap calls. like, if you're touching more than one regmap call, you go through her first. no skipping the line 🔒
• irq_lock — a spinlock protecting interrupt mask register updates. heads up: this is the MMIO path only. different lock, different lane 🛣️
• masked_temp — the currently masked temperature alarm bits. who's silenced rn 😭
• temp_mask — the temperature interrupt configuration mask. the actual config, not the live state. iykyk 🎯
• temp_hysteresis — cached DEVICE_TEMP hysteresis, in millicelsius. yes, milli. be precise bestie 🌡️
• sysmon_unmask_work — a struct delayed_work that re-enables events after the alarm condition clears. she's the cleanup crew, showing up fashionably late but she DOES show up 🫶
• temp_oversampling — the current temp oversampling ratio. more samples, more slay 🍓
• supply_oversampling — the current supply oversampling ratio. she's temp's bestie, they match 🌸

lowkey important: lock covers the threshold registers and cached state that spans multiple regmap calls, while irq_lock is strictly for interrupt mask register updates on the MMIO path only. don't mix them up, bestie 💀

👀 SEE ALSO 👀

• Kernel file ./drivers/iio/adc/versal-sysmon.h — go read the source, it's giving main character energy 📖👑

aaaand that's the whole vibe check, bestie 💖 this was struct sysmon from the Kernel API Manual, living in ./drivers/iio/adc, dated October 2026. periodt. go forth and read them registers responsibly ✨🎀🦋