genphy_c45_o...e_test_start(9)

🌸 NAME

okay so welcome to the genphy_c45_o...e_test_start(9) page from the Kernel API Manual, bestie. The function is genphy_c45_oatc14_cable_test_start — and it literally starts a cable test on an OATC14 10Base-T1S PHY. main character energy for cable diagnostics, no cap. 💅

✨ SYNOPSIS

the signature is giving exactly this:

int genphy_c45_oatc14_cable_test_start (struct phy_device *phydev );

🫶 ARGUMENTS

• phydev — a pointer to the PHY device structure, aka the thing you're poking. 🫶

💅 DESCRIPTION

okay so here's the tea: this function initiates a cable diagnostic test on a Clause 45 OATC14 10Base-T1S capable PHY device. First it reads the PHY’s advanced diagnostic capability register to check if High Definition Diagnostics (HDD) mode is supported. If the PHY does not report HDD capability, cable testing is not supported and the function returns -EOPNOTSUPP. no HDD, no cable-test party 😭

For PHYs that support HDD, the function sets the appropriate control bits in the OATC14_HDD register to enable and start the cable diagnostic test. slay ✨

🎀 RETURN

• 0 on success — we love a zero ✅
• -EOPNOTSUPP if the PHY does not support HDD capability — rude but fair 💀
• A negative error code on I/O or register access failures — yeah, those can happen 🙈

🦋 SEE ALSO

Kernel file: ./drivers/net/phy/phy-c45.c

the whole SEE ALSO squad, iykyk:

• genphy_c45_baset1_able(9)
• genphy_c45_pma_can_sleep(9)
• genphy_c45_pma_resume(9)
• genphy_c45_pma_suspend(9)
• genphy_c45_pma_baset1_setup_master_slave(9)
• genphy_c45_pma_setup_forced(9)
• genphy_c45_an_config_aneg(9)
• genphy_c45_an_disable_aneg(9)
• genphy_c45_restart_aneg(9)
• genphy_c45_check_and_restart_aneg(9)
• genphy_c45_pma_soft_reset(9)
• genphy_c45_an_setup_master_slave(9)
• genphy_c45_read_master_slave(9)
• genphy_c45_aneg_done(9)
• genphy_c45_read_link(9)
• genphy_c45_read_lpa(9)
• genphy_c45_pma_baset1_read_master_slave(9)
• genphy_c45_read_pma(9)
• genphy_c45_read_mdix(9)
• genphy_c45_write_eee_adv(9)
• genphy_c45_read_eee_adv(9)
• genphy_c45_read_eee_lpa(9)
• genphy_c45_read_eee_cap1(9)
• genphy_c45_read_eee_cap2(9)
• genphy_c45_read_eee_abilities(9)
• genphy_c45_an_config_eee_aneg(9)
• genphy_c45_pma_baset1_read_abilities(9)
• genphy_c45_pma_read_ext_abilities(9)
• genphy_c45_pma_read_abilities(9)
• genphy_c45_read_status(9)
• genphy_c45_config_aneg(9)
• genphy_c45_fast_retrain(9)
• genphy_c45_plca_get_cfg(9)
• genphy_c45_plca_set_cfg(9)
• genphy_c45_plca_get_status(9)
• genphy_c45_eee_is_active(9)
• genphy_c45_ethtool_get_eee(9)
• genphy_c45_ethtool_set_eee(9)
• oatc14_cable_test_get_result_code(9)
• genphy_c45_oatc14_cable_test_get_status(9)
• oatc14_update_sqi_capability(9)
• genphy_c45_oatc14_get_sqi_max(9)
• genphy_c45_oatc14_get_sqi(9)

okay that's the page, bestie! 💖 The footer source/version is ./drivers/net/phy, dated October 2026, and the footer title is genphy_c45_o...e_test_start(9). mwah, go be iconic. 💅✨