include/linux/phylink.h

25 	/* PCS "negotiation" mode.
149  *                        are supported by the MAC/PCS.
170  * @mac_select_pcs: Select a PCS for the interface mode.
212  * mac_select_pcs: Select a PCS for the interface mode.
214  * @interface: PHY interface mode for PCS
219  * This must not modify any state. It is used to query which PCS should
222  * set the PCS that will be used.
271  * the results of in-band negotiation/status from the MAC PCS should be used
335  * complete any necessary steps after the MAC and PCS have been configured
374  * where these settings are not automatically conveyed from the PCS block,
395  * struct phylink_pcs - PHYLINK PCS instance
398  * @neg_mode: provide PCS neg mode via "mode" argument
399  * @poll: poll the PCS for link changes
401  *                 to always be on. Standalone PCS drivers which
405  * This structure is designed to be embedded within the PCS private data,
406  * and will be passed between phylink and the PCS.
409  * the PCS driver.
420  * struct phylink_pcs_ops - MAC PCS operations structure.
422  * @pcs_enable: enable the PCS.
423  * @pcs_disable: disable the PCS.
426  * @pcs_get_state: read the current MAC PCS link state from the hardware.
427  * @pcs_config: configure the MAC PCS for the selected mode and state.
429  * @pcs_link_up: program the PCS for the resolved link configuration
431  * @pcs_pre_init: configure PCS components necessary for MAC hardware
435 	int (*pcs_validate)(struct phylink_pcs *pcs, unsigned long *supported,
437 	int (*pcs_enable)(struct phylink_pcs *pcs);
438 	void (*pcs_disable)(struct phylink_pcs *pcs);
439 	void (*pcs_pre_config)(struct phylink_pcs *pcs,
441 	int (*pcs_post_config)(struct phylink_pcs *pcs,
443 	void (*pcs_get_state)(struct phylink_pcs *pcs,
445 	int (*pcs_config)(struct phylink_pcs *pcs, unsigned int neg_mode,
449 	void (*pcs_an_restart)(struct phylink_pcs *pcs);
450 	void (*pcs_link_up)(struct phylink_pcs *pcs, unsigned int neg_mode,
452 	int (*pcs_pre_init)(struct phylink_pcs *pcs);
458  * @pcs: a pointer to a &struct phylink_pcs.
470 int pcs_validate(struct phylink_pcs *pcs, unsigned long *supported,
474  * pcs_enable() - enable the PCS.
475  * @pcs: a pointer to a &struct phylink_pcs.
477 int pcs_enable(struct phylink_pcs *pcs);
480  * pcs_disable() - disable the PCS.
481  * @pcs: a pointer to a &struct phylink_pcs.
483 void pcs_disable(struct phylink_pcs *pcs);
487  * @pcs: a pointer to a &struct phylink_pcs.
490  * Read the current inband link state from the MAC PCS, reporting the
497 void pcs_get_state(struct phylink_pcs *pcs,
501  * pcs_config() - Configure the PCS mode and advertisement
502  * @pcs: a pointer to a &struct phylink_pcs.
508  * Configure the PCS for the operating mode, the interface mode, and set
515  * For SGMII, there is no advertisement from the MAC side, the PCS should
518  * For 1000BASE-X, the advertisement should be programmed into the PCS.
523  * functions, or for PCS that set pcs->neg_mode true, should be tested
526 int pcs_config(struct phylink_pcs *pcs, unsigned int neg_mode,
532  * @pcs: a pointer to a &struct phylink_pcs.
534  * When PCS ops are present, this overrides mac_an_restart() in &struct
537 void pcs_an_restart(struct phylink_pcs *pcs);
540  * pcs_link_up() - program the PCS for the resolved link configuration
541  * @pcs: a pointer to a &struct phylink_pcs.
547  * This call will be made just before mac_link_up() to inform the PCS of
548  * the resolved link parameters. For example, a PCS operating in SGMII
553  * functions, or for PCS that set pcs->neg_mode true, should be tested
556 void pcs_link_up(struct phylink_pcs *pcs, unsigned int neg_mode,
560  * pcs_pre_init() - Configure PCS components necessary for MAC initialization
561  * @pcs: a pointer to a &struct phylink_pcs.
565  * should not be called after the link is brought up, as reconfiguring the PCS
569  * their associated PCS device before they can properly initialize their own
571  * which requires an active REF_CLK signal to be provided by the PHY/PCS.
573  * By calling phylink_pcs_pre_init(), MAC drivers can ensure that the PCS is
577  * model of PCS and the requirements of the MAC device attached to it. PCS
580  * driver authors should document their requirements for the PCS
584 int pcs_pre_init(struct phylink_pcs *pcs);
607 int phylink_pcs_pre_init(struct phylink *pl, struct phylink_pcs *pcs);
647  * phylink_get_link_timer_ns - return the PCS link timer value
650  * Return the PCS link timer setting in nanoseconds for the PHY @interface
673 void phylink_mii_c22_pcs_get_state(struct mdio_device *pcs,
677 int phylink_mii_c22_pcs_config(struct mdio_device *pcs,
681 void phylink_mii_c22_pcs_an_restart(struct mdio_device *pcs);
685 void phylink_mii_c45_pcs_get_state(struct mdio_device *pcs,