zl3073x_chan_state_set(9)

📦 version 7.3.1, in nixpkgs unstable

💅 zl3073x_chan_state_set — kernel API manual energy ✨

okay so bestie, welcome to the glow-up of zl3073x_chan_state_set(9) from the Kernel API Manual — she's a DPLL channel function and she commits 💖

🌸 NAME 🌸

zl3073x_chan_state_set — commit DPLL channel state changes to hardware, no cap 👑

✨ SYNOPSIS ✨

int zl3073x_chan_state_set (struct zl3073x_dev *zldev , u8 index , const
struct zl3073x_chan *chan );

like, that's the whole signature, character for character, don't @ me 🫶

🎀 ARGUMENTS 🎀

  • zldev — pointer to zl3073x_dev structure. it's giving "the device, obviously" 💅
  • index — the DPLL channel index you're setting state for. which channel? this one ✨
  • chan — the desired channel state. the vibes you want her to have 🦋

🔥 DESCRIPTION 🔥

okay so here's the tea ☕ — she skips the HW write if the configuration is unchanged, because why waste a hardware write when nothing moved? iconic, honestly. lowkey efficient queen 👑

but if stuff did change? then she writes only the changed registers to hardware. not all of them. just the changed ones. minimal effort, maximum slay 💅

and here's the detail you cannot miss (iykyk):

  • the mode_refsel register is written directly ✨
  • the reference priority registers are written via the DPLL mailbox interface 📬

two different routes, one function. main character energy fr fr 🌈

🌟 RETURN 🌟

  • 0 on success 🎉
  • <0 on HW error 😭 (and yes, that's literally less than zero, negative numbers mean the hardware said no)

🌼 SEE ALSO 🌼

kernel file ./drivers/dpll/zl3073x/chan.c plus the whole friend group 🫶:

bestie heads up: this whole page is the property of ./drivers/dpll/zl3073x, dated October 2026 — mwah, drink water, and go commit those state changes 💖🧚‍♀️
📦 where this page comes from