zl3073x_chan_phase_step(9)

📦 version 7.3.1, in nixpkgs unstable

💅 zl3073x_chan_phase_step(9) — like, the kernel API manual one 🎀

okay bestie, buckle up, because we're diving into the Kernel API Manual page for zl3073x_chan_phase_step(9) and honestly? it's giving "small function, big responsibilities" ✨

🌸 NAME 🌸

zl3073x_chan_phase_step — execute one output phase step operation 🦋

like, one single step. one. that's the whole job. no cap.

✨ SYNOPSIS ✨

int zl3073x_chan_phase_step (struct zl3073x_dev *zldev , u8 ch , u16
out_mask , s32 step_cycles , bool tod_step );

that signature is literally five parameters long and every one of them matters, so let's go through them one by one, main character by main character 👑

🫶 ARGUMENTS 🫶

  • zldev — pointer to zl3073x device 💖 like, your actual device, the whole vibe, the thing you're stepping.
  • ch — DPLL channel index 🎀 which channel are we on bestie, pick one.
  • out_mask — bitmask of outputs to step ⭐ every bit you set gets stepped, every bit you leave off sits this one out.
  • step_cycles — phase step in synthesizer clock cycles 🔥 note the units: synthesizer clock cycles, not nanoseconds, not vibes.
  • tod_step — also step the ToD counter 🕰️ yeah, the time-of-day counter. bool. yes/no. iconic.

🌈 DESCRIPTION 🌈

So here's the one thing you absolutely cannot skip 🙈 — all masked outputs must use synthesizers of the same frequency, because the step value is in synthesizer clock cycles. that's it. that's the constraint. if your masked outputs are running different synthesizer frequencies, the math doesn't math and you've got a problem, so check that first, iykyk 💅

fr fr, read that constraint twice. same frequency across every masked output. it's not a suggestion, it's how the cycles convert. 💀

👑 RETURN 👑

  • 0 on success 🎉 slay, it worked
  • <0 on error 😭 something went sideways, it's negative, you know the drill

🦋 SEE ALSO 🦋

the whole friend group 🫶 — kernel file ./drivers/dpll/zl3073x/chan.c and honestly the entire chan.c cinematic universe:

and that's the page, bestie 🧚 this little gem lives in ./drivers/dpll/zl3073x and it's dated October 2026 — yes, October 2026, the manpage said so and I don't make the rules 💜 mwah, go step some phases 💅

📦 where this page comes from