zl3073x_ref_state_set(9)

💅 zl3073x_ref_state_set(9) — like, the Kernel API Manual bestie ✨

okay so picture this: it's giving kernel API manual energy, it's zl3073x_ref_state_set(9), and she's here to commit your input reference state changes to the actual hardware. no cap. 🎀

---

🌸 NAME 🌸

zl3073x_ref_state_set — commit input reference state changes to hardware. that's it, that's the whole vibe. she takes your changes and makes them real. 🔥

---

✨ SYNOPSIS ✨

int zl3073x_ref_state_set (struct zl3073x_dev *zldev , u8 index , const
struct zl3073x_ref *ref );

like, three args, one int back, we love a clean signature. 🫶

---

🦋 ARGUMENTS 🦋

• zldev — pointer to zl3073x_dev structure. the main character device, obvs.
• index — input reference index to set state for. which ref are we talking about? this one. 📍
• ref — desired reference state. the dream, the goal, the aesthetic she's aiming for. 💖

---

👑 DESCRIPTION 👑

so here's the whole plot, bestie:

first she validates that invariant fields have not been modified — like a vibe check on the fields that are not allowed to change. you don't get to mess with those, periodt. 🚫

then she skips the HW write if the mutable configuration is unchanged — if nothing that's actually allowed to move has moved, she just... doesn't bother the hardware. iconic lazy-girl efficiency, honestly. no wasted mailbox traffic. 💅

and otherwise? writes only the changed cfg fields to hardware via the mailbox interface. just the diffs, nothing extra. she's not gonna rewrite the whole struct when only a couple cfg fields popped off. 🔥

---

💀 RETURN 💀

• 0 on success — slay, we ate, everything worked. ✨
• -EINVAL if invariants changed — you touched the forbidden fields bestie, that's a hard no. 🙈
• <0 on HW error — something in the hardware went sideways, and that's on periodt. 😭

---

🔍 SEE ALSO 🔍

• Kernel file ./drivers/dpll/zl3073x/ref.c
• zl3073x_ref_freq_factorize(9)
• zl3073x_ref_state_update(9)
• zl3073x_ref_state_fetch(9)
• zl3073x_ref_state_get(9)

go read those too, iykyk. 📚💜

---

and that's the whole page, bestie! 🧚 source/version vibes: ./drivers/dpll/zl3073x, dated October 2026, and yes this was zl3073x_ref_state_set(9) the entire time. mwah 💋🎀🌸