ufshcd_tx_eqtr_prepare(9)

okay bestie, welcome to the Kernel API Manual page for ufshcd_tx_eqtr_prepare(9) 💅 this one is all about getting the UFS link ready for TX EQTR, and yes, we're keeping every detail, no cap.

💖 NAME 💖

ufshcd_tx_eqtr_prepare — Prepare UFS link for TX EQTR procedure ✨

🎀 SYNOPSIS 🎀

int ufshcd_tx_eqtr_prepare (struct ufs_hba *hba , struct
       ufs_pa_layer_attr *pwr_mode );

🦋 ARGUMENTS 🦋

• hba — per adapter instance, aka the HBA bestie we're working with 🫶
• pwr_mode — target power mode containing gear and rate 🌸

💖 DESCRIPTION 💖

okay so this function prepares the UFS link for TX Equalization Training (EQTR) by establishing the proper initial conditions required by the EQTR procedure. it's giving setup era, fr fr ✨

it ensures that EQTR starts from the most reliable Power Mode (HS-G1) with all connected lanes activated, and it sets host TX HS Adapt Type to INITIAL. iconic behavior, honestly 👑

returns 0 on successful preparation, negative error code on failure 😭

🌈 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(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)

mwah 💋 this cutie came from ./drivers/ufs/core, October 2026 — periodt. 🌈💖