zl3073x_ref_...fsets_update(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… zl3073x_ref_phase_offsets_update

okay bestie, so this page is from the Kernel API Manual and it's all about zl3073x_ref_phase_offsets_update β€” yeah that name is a mouthful, i know, but she's iconic so we move πŸŽ€

✨ NAME ✨

zl3073x_ref_phase_offsets_update β€” literally just updates the reference phase offsets, no cap πŸ’–


πŸ¦‹ SYNOPSIS πŸ¦‹

int zl3073x_ref_phase_offsets_update (struct zl3073x_dev *zldev , int channel );

🌸 ARGUMENTS 🌸

  • zldev β€” a pointer to the zl3073x_dev structure. that's your device bestie 🫢
  • channel β€” the DPLL channel number, or -1 if you're not about that life πŸ™ˆ

πŸ’œ DESCRIPTION πŸ’œ

So the way this works: the function asks the device to update its phase offsets latch registers with the latest measured values. Very demure, very mindful.

There are 2 sets of latch registers, and you need to know both:

  1. Up to 5 DPLL-to-connected-ref registers β€” these hold phase offset values between a particular DPLL channel and its connected input reference.
  2. 10 selected-DPLL-to-all-ref registers β€” these hold phase offset values between the selected DPLL channel and all input references.

So here's the vibe check on which one you get:

  • If the caller is interested in 2), it has to pass the DPLL channel number in the channel parameter πŸ”₯
  • If it's interested only in 1), then it should pass channel with a value of -1 ⭐

periodt. that's the whole routing situation 🧚


πŸ’€ RETURN πŸ’€

  • 0 on success πŸ’–
  • <0 on error 😭

πŸ‘‘ SEE ALSO πŸ‘‘

Kernel file ./drivers/dpll/zl3073x/core.c and honestly the whole friend group:

zl3073x_read_u8(9), zl3073x_write_u8(9), zl3073x_read_u16(9), zl3073x_write_u16(9), zl3073x_read_u32(9), zl3073x_write_u32(9), zl3073x_read_u48(9), zl3073x_write_u48(9), zl3073x_poll_zero_u8(9), zl3073x_do_hwreg_op(9), zl3073x_read_hwreg(9), zl3073x_write_hwreg(9), zl3073x_update_hwreg(9), zl3073x_write_hwreg_seq(9), zl3073x_ref_freq_meas_latch(9), zl3073x_ref_freq_meas_update(9), zl3073x_dev_phase_meas_setup(9), zl3073x_dev_start(9), zl3073x_dev_stop(9), zl3073x_dev_probe(9)


and that's the whole page bestie, mwah πŸ’‹ this lil cutie lives in ./drivers/dpll/zl3073x and dropped way back in October 2026 β€” go read her siblings, they ate too πŸ“πŸ’…

πŸ“¦ where this page comes from