STRUCT VEML6046X00_GAIN_PD(9)

✨ struct veml6046x00_gain_pd(9) ✨

okay so bestie, welcome to the Kernel API Manual 💅 this is the page for struct veml6046x00_gain_pd, and it's literally just a little lookup table with main character energy. it's giving "translation dictionary" but for sensor settings 🦋

---

🌸 NAME 🌸

struct veml6046x00_gain_pd — Translation of gain and photodiode size (PD).

like, it speaks both languages: driver-speak and sensor-hardware-speak 🫶

---

🎀 SYNOPSIS 🎀

struct veml6046x00_gain_pd {
    unsigned int gain_sen;
    unsigned int pd;
 };

(yeah the closing brace is indented one space in the original, and we keep it exactly, no touchy ✨)

---

👑 Members 👑

• gain_sen — the gain actually used in the sensor, as described in the datasheet of the sensor. that's the raw hardware truth 💖
• pd — the photodiode size in the sensor. yes, the PD of the PD. obsessed 😭

---

💜 Description 💜

so here's the vibe: this is the translation table 🧚 that maps the gain used in the driver (which is also the gain the userspace interface in sysfs uses) over to the gain and the PD that the sensor hardware actually gets.

there are six gain values visible to the user (0.25 .. 2), and those translate to:

• two different gains in the sensor hardware (x0.5 .. x2), and
• two PD values (1/2 and 2/2).

theoretically there would be eight combinations, but plot twist 🌈 — the gain values 0.5 and 1 are doubled, so for those the combination with the larger PD (2/2) is the one that gets taken. the reasoning is honestly iconic: more photodiode cells are supposed to deliver a more precise result, so the bigger PD wins. periodt 💅

ngl, this is the whole reason the struct exists: the user sees 6, the hardware sees fewer, and the table does the matchmaking 💖

---

🦋 SEE ALSO 🦋

• Kernel file ./drivers/iio/light/veml6046x00.c
• struct veml6046x00_rf(9)
• struct veml6046x00_data(9)
• Valid integration times (IT)(9)
• Handling of gain and photodiode size (PD)(9)
• Factors for calculation of lux(9)
• veml6046x00_read_data_ready(9)
• veml6046x00_wait_data_available(9)

go read those next bestie, iykyk 📚✨

---

and that's the page! 🎀 this one lives in ./drivers/iio/light, dated October 2026, and it's filed under struct veml6046x00_gain_pd(9) — mwah, slay, bye 💋💜