STRUCT IIO_ITIME_SEL_MUL(9)

💅 struct iio_itime_sel_mul(9) — the integration time glow-up

okay bestie, welcome to the Kernel API Manual ✨ this one's a lil struct that basically explains how long your sensor stares at the world and how much that stare gets amplified. it's giving very much "photography exposure but make it kernel" 📸

---

🦋 NAME 🦋

struct iio_itime_sel_mul — integration time description, and honestly? it's the whole personality of your sensor's timing situation 💖

---

✨ SYNOPSIS ✨

struct iio_itime_sel_mul {
    int time_us;
    int sel;
    int mul;
 };

like, three ints. that's it. that's the struct. no cap, minimal and iconic 👑

---

🌸 Members 🌸

• time_us — the integration time in microseconds ⏱️ real talk: time values must be positive, because negative values are reserved for error handling. so pls don't put a negative in there unless you're literally signalling an error, iykyk 🙈
• sel — the selector, which is usually a register value, and it's what you use to point at this specific time 🎯 it's basically the time's little name tag at the register party.
• mul — the multiplication applied to the values caused by this time 🔥 so like, this time slot → this much gain. the multiplier, the amplifier, the drama.

---

🧚 DESCRIPTION 🧚

okay so picture this: lots of devices — light sensors especially, they're the main character here — let you set the duration for collecting data. like how long the sensor is out there gathering vibes 🌈

and typically? that duration also has an impact on the magnitude of the measured values, aka the gain. the way that works is: this structure describes the relation between integration time and amplification, plus the corresponding selector (which, again, is usually the register value) 🎀

a whole example, because examples ate: say you've got a sensor that allows 50, 100, 200 and 400 mS times 🕐 the respective multiplication values could be 50 mS => 1, 100 mS => 2, 200 mS => 4 and 400 mS => 8. and that's assuming the impact of integration time is linear — in a way that when collecting data for 50 mS caused value X, doubling the data collection time caused value 2X, etc. 💫 literally doubling the time, doubling the value. slay.

---

⭐ NOTE ⭐

bestie, read this part, it's the vibe check 🫶

• Only selectors >= 0 supported. no negatives, periodt 💀
• Only multipliers > 0 supported. strictly greater than zero, zero is not invited to this party 🙅‍♀️

---

🔥 SEE ALSO 🔥

• Kernel file ./include/linux/iio/iio-gts-helper.h — struct iio_gain_sel_pair(9)
• iio_gts_find_int_time_by_sel(9)
• iio_gts_find_sel_by_int_time(9)
• iio_gts_valid_time(9)
• iio_gts_valid_gain(9)

all of these are the supporting cast and they're lowkey essential, go read them 💜

---

alright bestie, that's the whole page 🌸 this lil kernel doc lives at ./include/linux/iio, dated October 2026, and it's filed under struct iio_itime_sel_mul(9) — mwah, go forth and set your integration times correctly 💅✨🎀