phy_calibrate(9)

🌸 phy_calibrate(9) 🌸

okay bestie, welcome to the Kernel API Manual — this one's about phy_calibrate, and it's lowkey iconic. let's get into it 💅

---

✨ NAME ✨

phy_calibrate — tunes the phy hw parameters for the current configuration, no cap 🎀

---

🦋 SYNOPSIS 🦋

int phy_calibrate (struct phy *phy );

---

💖 ARGUMENTS 💖

• phy — the phy that got returned by phy_get, bestie 🫶

---

🌈 DESCRIPTION 🌈

so this function is used to calibrate phy hardware. it's typically doing the most by adjusting some parameters at runtime — and the way that matters is huge because those params are otherwise lost after a host controller reset 😭 like, they literally cannot be applied in phy_init or phy_power_on, so this is the main character move that saves the day ✨

---

⭐ RETURN ⭐

• 0 if it's successful, slay 👑
• a negative error code otherwise — tragic, but we move 💀

---

🎀 SEE ALSO 🎀

kernel file ./drivers/phy/phy-core.c, plus the whole friend group 🫶:

• phy_create_lookup(9)
• phy_remove_lookup(9)
• phy_init(9)
• phy_exit(9)
• phy_power_on(9)
• phy_power_off(9)
• phy_notify_connect(9)
• phy_notify_disconnect(9)
• phy_notify_state(9)
• phy_configure(9)
• phy_validate(9)
• _of_phy_get(9)
• of_phy_get(9)
• of_phy_put(9)
• phy_put(9)
• devm_phy_put(9)
• of_phy_simple_xlate(9)
• phy_get(9)
• devm_phy_get(9)
• devm_phy_optional_get(9)
• devm_of_phy_get(9)
• devm_of_phy_optional_get(9)
• devm_of_phy_get_by_index(9)
• phy_create(9)
• devm_phy_create(9)
• phy_destroy(9)
• devm_phy_destroy(9)
• __of_phy_provider_register(9)
• __devm_of_phy_provider_register(9)
• of_phy_provider_unregister(9)
• devm_of_phy_provider_unregister(9)
• phy_release(9)

---

aaaaand that's the whole vibe check! 💜 this lil page lives in ./drivers/phy and the version is dated October 2026 — go off, bestie, you're literally a kernel dev now 🧚✨