zl3073x_chan_tod_write(9)
π zl3073x_chan_tod_write β the kernel API manual, bestie edition β¨
okay so you found the zl3073x_chan_tod_write page in the Kernel API Manual and you're like "what does this even do" β don't worry, I got you π«Ά. Real talk: this function writes the ToD registers and then triggers a 1 Hz update. Two things, one call, iconic behavior honestly π
β¨ SYNOPSIS β¨
int zl3073x_chan_tod_write (struct zl3073x_dev *zldev , u8 ch , struct
timespec64 ts );
that's the whole signature, don't come for me about the line break, that's literally how it's printed π
πΈ ARGUMENTS πΈ
zldevβ pointer to the zl3073x device π this is your device, your main characterchβ the DPLL channel index π so like, which channel we're talking totsβ the time to set β° the whole point of the operation tbh
π¦ CONTEXT π¦
heads up, this is important, no cap: the caller must serialize all zl3073x_chan_tod_* calls externally. as in, you handle the locking, bestie β the function is not gonna do it for you. so like every single one of those zl3073x_chan_tod_* calls needs to be serialized by you on the outside π«Ά
ngl this is the kind of thing where if you skip it, things get real weird real fast π external serialization, periodt.
π RETURN π
0β success, slay, we ate π<0β error, it's giving unfortunate π
π SEE ALSO π
kernel file ./drivers/dpll/zl3073x/chan.c β go read it, it's right there π
and the whole bestie squad of related calls:
zl3073x_chan_state_update(9)zl3073x_chan_nco_mode_set(9)zl3073x_chan_state_fetch(9)zl3073x_chan_state_get(9)zl3073x_chan_tod_ready_wait(9)zl3073x_chan_tod_ctrl(9)zl3073x_chan_tod_read(9)zl3073x_chan_tod_adjust(9)zl3073x_chan_df_offset_set(9)zl3073x_chan_tie_write(9)zl3073x_chan_phase_step(9)zl3073x_chan_state_set(9)
that's the page, bestie π
β¨ this whole thing lives in ./drivers/dpll/zl3073x and it's dated October 2026 β so like, future vibes π¦. mwah, go write those ToD registers ππ
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms