ufshcd_apply_tx_eq_settings(9)

🦋 ufshcd_apply_tx_eq_settings — the Kernel API Manual moment

Okay bestie, so this page is literally from the Kernel API Manual and it's all about ufshcd_apply_tx_eq_settings — the function that applies TX Equalization settings for the target gear ✨. Yes, that's the whole NAME section, and no, I'm not going to make it longer than it needs to be, because the kernel is already doing the most.

---

🌸 SYNOPSIS

int ufshcd_apply_tx_eq_settings (struct ufs_hba *hba , struct
       ufshcd_tx_eq_params *params , u32 gear );

Three things go in, an int comes out. It's giving "small function, big responsibility" 💅

---

🎀 ARGUMENTS

• hba — the per adapter instance 🫶 like, the one UFS host controller adapter we're working with, bestie.
• params — the TX EQ parameters data structure 🌈 this is where all the equalization goodies live.
• gear — the target gear 👑 the gear we're aiming for, fr fr.

---

💖 DESCRIPTION

Returns 0 on success, negative error code otherwise. That's it. That's the description. Short and iconic — not me being lazy, the manpage literally said that, no cap 😭

Lowkey the whole deal: you hand it the adapter, the params, and the gear, and it either slays (0) or hands you back a negative error code. Check your return values, bestie, always 💀

---

🔥 SEE ALSO

The kernel file is ./drivers/ufs/core/ufs-txeq.c and honestly the whole friend group is here — go say hi to:

• ufshcd_configure_precoding(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_retrain_tx_eq(9)
• ufshcd_extract_tx_eq_settings_attrs(9)
• ufshcd_update_tx_eq_settings_attrs(9)

---

And that's the tea ☕ this one dropped out of ./drivers/ufs/core, dated October 2026, and it goes by ufshcd_apply_tx_eq_settings(9) — mwah, periodt 💋💜