ufshcd_retrain_tx_eq(9)

💅 ufshcd_retrain_tx_eq(9) — like, the Kernel API Manual page you didn't know you needed 🎀

okay bestie, sit down, grab a strawberry 🍓, because this is the page for ufshcd_retrain_tx_eq from the Kernel API Manual and it's honestly giving "small function, big vibes."

---

✨ NAME ✨

ufshcd_retrain_tx_eq — retrains your TX Equalization and then goes ahead and applies the new settings 💅 no cap, that's literally the whole job.

---

🦋 SYNOPSIS 🦋

int ufshcd_retrain_tx_eq (struct ufs_hba *hba , u32 gear );

like yes, that's it, that's the signature, copy it exactly, do not touch it 🙈

---

🌸 ARGUMENTS 🌸

• hba — the per-adapter instance. your lil adapter baby. the one and only 🫶
• gear — the target High-Speed (HS) gear for retraining. this is the gear we're aiming at, bestie ⭐

---

🔥 DESCRIPTION 🔥

okay so here's the tea 👑: this function kicks off a refresh of the TX Equalization settings for one specific HS gear. it's not doing a little touch-up, it's doing the full routine:

• it scales the clocks to maximum frequency — we're going full send on the clock speed ⚡
• it negotiates the power mode with the device — gotta talk it out first, communication is key 💖
• it retrains TX EQ — the main character of this whole page tbh
• and then it applies the new TX EQ settings by conducting a Power Mode change ✨

and the return? 0 on success, non-zero error code otherwise. periodt. if you get non-zero, something did not slay 😭

---

💜 SEE ALSO 💜

the whole friend group, iykyk 🌈. also heads up, this lives in the kernel file ./drivers/ufs/core/ufs-txeq.c:

• ufshcd_configure_precoding(9)
• ufshcd_apply_tx_eq_settings(9)
• ufshcd_evaluate_tx_eqtr_fom(9)
• ufshcd_get_rx_fom(9)
• tx_eqtr_iter_try_update(9)
• tx_eqtr_iter_update(9)
• ufshcd_tx_eqtr_iter_init(9)
• adapt_cap_to_t_adapt(9)
• adapt_cap_to_t_adapt_l0l3(9)
• adapt_cap_to_t_adapt_l0l1l2l3(9)
• ufshcd_setup_tx_eqtr_adapt_length(9)
• ufshcd_compose_tx_eqtr_setting(9)
• ufshcd_apply_tx_eqtr_settings(9)
• ufshcd_update_tx_eq_params(9)
• __ufshcd_tx_eqtr(9)
• ufshcd_tx_eqtr_prepare(9)
• ufshcd_tx_eqtr(9)
• ufshcd_config_tx_eq_settings(9)
• ufshcd_apply_valid_tx_eq_settings(9)
• ufshcd_extract_tx_eq_settings_attrs(9)
• ufshcd_update_tx_eq_settings_attrs(9)

---

anyway bestie, that's the page 🧚 this came out of ./drivers/ufs/core, dated October 2026, and it's the ufshcd_retrain_tx_eq(9) page from the Kernel API Manual 💖 go retrain something, you're gonna ate 🔥👑