DRV_ETHPHY_NegotiationIsComplete Function

C

DRV_ETHPHY_RESULT DRV_ETHPHY_NegotiationIsComplete(DRV_HANDLE handle, DRV_ETHPHY_INTERFACE_INDEX portIndex, bool waitComplete); 

Returns

  • DRV_ETHPHY_RES_PENDING operation is ongoing

  • an DRV_ETHPHY_RESULT error code if the procedure failed.

Description

This function returns the results of a previously initiated Ethernet PHY negotiation.

Remarks

Use DRV_ETHPHY_ClientStatus() and DRV_ETHPHY_ClientOperationResult() to check when the operation was completed and its outcome. When operation is completed but negotiation has failed, DRV_ETHPHY_ClientOperationResult will return:

  • DRV_ETHPHY_RES_NEGOTIATION_INACTIVE if no negotiation in progress

  • DRV_ETHPHY_RES_NEGOTIATION_NOT_STARTED if negotiation not yet started yet (means time out if waitComplete was requested)

  • DRV_ETHPHY_RES_NEGOTIATION_ACTIVE if negotiation ongoing (means time out if waitComplete was requested). See also DRV_ETHPHY_NegotiationResultGet.

Preconditions

  • The DRV_ETHPHY_Initialize routine must have been called.

  • DRV_ETHPHY_Open must have been called to obtain a valid device handle.

  • DRV_ETHPHY_Setup must have been called to properly configure the PHY

  • DRV_ETHPHY_RestartNegotiation should have been called.