tx_eqtr_iter_try_update(9)

💅 tx_eqtr_iter_try_update — the kernel API manual page, bestie edition

okay so real talk: this is a page from the Kernel API Manual, section 9. It's giving "niche kernel function that only your UFS driver friend knows about" and honestly? iconic. Let's get into it 🫶

---

✨ NAME ✨

tx_eqtr_iter_try_update — the function that tries to update a TX EQTR iterator. Emphasis on tries, because it's gonna vibe-check your values first 👀

---

🌸 SYNOPSIS 🌸

void tx_eqtr_iter_try_update (struct tx_eqtr_iter *iter , u8 preshoot ,
u8 deemphasis );

so it returns nothing (void, no take-backs) and it takes three things: an iterator pointer, a preshoot, and a deemphasis. the way that signature is literally just three little params, we love a low-arg-count king 👑

---

🎀 ARGUMENTS 🎀

• iter — the TX EQTR iterator data structure itself. this is the main character, the thing getting updated 💖
• preshoot — a u8 holding the PreShoot value. yes it's capitalized in the docs, yes we're keeping it that way ✨
• deemphasis — a u8 holding the DeEmphasis value. also capitalized, also staying. consistency queen 🎀

---

🦋 DESCRIPTION 🦋

okay so here's the tea ☕: this function validates whether the PreShoot + DeEmphasis combination you handed it can actually be used or not. it's a bouncer at the club, checking the guest list 💅

• if the answer is yes → it updates the TX EQTR iterator with the provided PreShoot and DeEmphasis 🎉
• and it also sets the is_updated flag, so everyone knows the iterator has officially been updated 🔥

if the answer is no… well, no update, no flag. that's the whole bit. simple, elegant, slay.

---

🌈 SEE ALSO 🌈

the friend group / the whole crew, in the order the page gives them 🫶

Kernel file ./drivers/ufs/core/ufs-txeq.c plus all these lovely functions:

• ufshcd_configure_precoding(9)
• ufshcd_apply_tx_eq_settings(9)
• ufshcd_evaluate_tx_eqtr_fom(9)
• ufshcd_get_rx_fom(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)

that's 21 friends plus the file, fr fr iykyk 🧚

---

and that's the page, bestie 💜 this little legend came out of the ./drivers/ufs/core source, dated October 2026, and was hand-delivered to you as tx_eqtr_iter_try_update(9) — go forth and update those iterators responsibly 👑💅