__ufshcd_tx_eqtr(9)

✨ __ufshcd_tx_eqtr(9) ✨

okay bestie, welcome to the Kernel API Manual 💅 today's main character is __ufshcd_tx_eqtr(9), and she is literally the whole TX Equalization Training procedure. buckle up 🎀

---

🌸 NAME 🌸

__ufshcd_tx_eqtr — TX Equalization Training (EQTR) procedure 👑

---

🦋 SYNOPSIS 🦋

int __ufshcd_tx_eqtr (struct ufs_hba *hba , struct ufshcd_tx_eq_params
*params , struct ufs_pa_layer_attr *pwr_mode );

no cap, that's the whole signature ⭐

---

💖 ARGUMENTS 💖

• hba — the per adapter instance, aka the device's little home base 🏠
• params — the TX EQ parameters data structure (all the settings live here fr) 🍓
• pwr_mode — the target power mode, which is what's carrying the gear and rate information 🚀

---

🔥 DESCRIPTION 🔥

so this function implements the complete TX EQTR procedure as defined in the UFSHCI v5.0 specification ✨ and the way she does it? she iterates through all the possible combinations of PreShoot and DeEmphasis settings 🌈 to find the optimal TX Equalization settings for all active lanes 💅

it's giving exhaustive-search-but-make-it-fashion 👑

returns 0 on success, negative error code otherwise 😭 (iykyk)

ngl bestie, remember: success is 0, anything negative means something went sideways — don't @ me, that's just the return value 🙈

---

🧚 SEE ALSO 🧚

• 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_prepare(9)
• ufshcd_tx_eqtr(9)
• ufshcd_config_tx_eq_settings(9)
• ufshcd_apply_valid_tx_eq_settings(9)
• ufshcd_retrain_tx_eq(9)
• ufshcd_extract_tx_eq_settings_attrs(9)
• ufshcd_update_tx_eq_settings_attrs(9)

like, that's the whole friend group right there 🫶 go say hi 💜

---

and that's the page, bestie 🥹 source lives in ./drivers/ufs/core, dated October 2026 — mwah, slay, periodt 💅✨