rockchip_sa...top_and_wait(9)

🎀 rockchip_sa...top_and_wait(9) 🎀

okay bestie, welcome to the Kernel API Manual — yes it's a whole manual page for one tiny function and honestly? she deserves it. this is rockchip_sai_xfer_clk_stop_and_wait and she's here to stop a clock and then wait about it. very main character, no notes 💅

---

✨ NAME ✨

rockchip_sai_xfer_clk_stop_and_wait — stop the xfer clock and wait for it to be idle 🛑⏳

like, that's literally her whole job. stop the clock, then vibe-check it until it's idle. periodt.

---

🌸 SYNOPSIS 🌸

void rockchip_sai_xfer_clk_stop_and_wait (struct rk_sai_dev *sai ,
unsigned int *to_restore );

note the return type: void. she gives nothing back. she simply does the task and leaves ✨

---

💖 ARGUMENTS 💖

• sai — pointer to the driver instance's rk_sai_dev struct 🫶 this is the little guy she's working on, iykyk
• to_restore — pointer to store the CLK/FSS register values in as they were found before they were cleared, or NULL. so like, if you pass a real pointer she'll save the receipts 📝, and if you pass NULL she just... won't. your call bb 🙈

---

🦋 DESCRIPTION 🦋

okay so here's the tea ☕:

she clears the XFER_CLK and XFER_FSS registers if needed, and then she busy-waits for the XFER clocks to be idle. busy-waiting! she's not sleeping, she's not napping, she is spinning and watching 👀🔥

and before she clears those bits — key detail, don't miss it — she stores the state of the registers as she encountered them into to_restore, but only if to_restore isn't NULL. so the original vibe is preserved for later, slay 💾✨

---

💜 CONTEXT 💜

any context. literally any. she's flexible like that 🧚

⚠️ but bestie — she expects sai->xfer_lock to be held by the caller. that's on you, not her. she is not grabbing that lock herself, she's trusting you to have done it already. don't do her dirty like that 💀

---

🌈 SEE ALSO 🌈

• Kernel file ./sound/soc/rockchip/rockchip_sai.c — go read the source, it's giving lore 📖👑

---

and that's the whole page, bestie!! stay hydrated, hold your locks, and remember: busy-waiting is valid but she's not easy 💖

— with love, from ./sound/soc/rockchip, dated October 2026 🎀🦋✨