mtk_pcie_retrain(9)

✨ mtk_pcie_retrain(9) ✨

okay so bestie, we're in the Kernel API Manual, and this page is literally mtk_pcie_retrain(9) — the little “retrain the root bridge link if needed” situation 💅

---

🎀 NAME 🎀

mtk_pcie_retrain — retrain the root bridge link if needed ✨

---

🌸 SYNOPSIS 🌸

int mtk_pcie_retrain (struct device *dev , struct pci_host_bridge *host
);

---

💖 ARGUMENTS 💖

• dev — the device, and it’s used for logging 🫶
• host — the host bridge which contains the link 👑

---

🦋 DESCRIPTION 🦋

okay so here’s the tea, bestie: due to what is likely a hardware bug, some devices (notably EcoNet) start up as Gen1, and they must be retrained once after initial configuration in order to reach Gen2. iconic but also annoying 😭

These devices always self-identify as Gen2 capable, but sometimes the PHY is only capable of Gen1 operation, and sometimes the PCIe card (e.g. wifi) is only Gen1 capable. so yeah, that’s the vibe 💀

Therefore it is most convenient to retrain every port after startup. periodt. ✨

---

🔥 SEE ALSO 🔥

• Kernel file ./drivers/pci/controller/pcie-mediatek.c enum
• mtk_pcie_quirks(9)
• struct mtk_pcie_soc(9)
• struct mtk_pcie_port(9)
• struct mtk_pcie(9)

---

source/version: ./drivers/pci/controller · date: October 2026 — bye bestie, go retrain that link 💅💖