SNIP_CLASSIC_ETHIF_SECTION_8_6_5_EthIf_MainFunctionState

8.6.5 EthIf_MainFunctionState [SWS_EthIf_91104] Definition of scheduled function EthIf_MainFunctionState ⌈ Service Name EthIf_MainFunctionState Syntax void EthIf_MainFunctionState ( void ) Service ID [hex] 0x05 Description The function is polling different communication hardware (Ethernet transceiver, Ethernet switch ports) related information, e.g. link state, signal quality. Available via EthIf_SchM.h ⌋ [SWS_EthIf_00407] ⌈The function EthIf_MainFunctionState shall poll Ethernet communication hardware related information with the period of EthIfMainFunctionStatePeriod.⌋ [SWS_EthIf_00408] ⌈For each Ethernet switch port where a link state ETHTRCV_LINK_STATE_ACTIVE is yielded and references an Ethernet Transceiver the function shall poll the signal quality by calling EthSwt_GetPortSignalQuality.⌋ [SWS_EthIf_00409] ⌈For each Ethernet transceiver where a link state of ETHTRCV_LINK_STATE_ACTIVE is yielded the function shall poll the signal quality by calling EthTrcv_GetPhySignalQuality.⌋ [SWS_EthIf_00410] ⌈The obtained signal quality value shall be stored as type of EthIf_SignalQualityResultType. The value shall always be stored as ActualSignalQuality. If the obtained signal quality is higher than the stored highest signal quality (HighestSignalQuality), then HighestSignalQuality shall be updated with the obtained signal quality. If the obtained signal quality is lower than the lowest signal quality (LowestSignalQuality), then LowestSignalQuality shall be updated with the obtained signal quality.⌋ [SWS_EthIf_00498] ⌈EthIf shall check its maintained Ethernet hardware (Ethernet switch port, Ethernet transceiver), if the Ethernet hardware has reached the requested mode and requested link state under the following conditions: • the timer to switch off the EthSwtPort (see EthIfSwitchOffPortTimeDelay) is not running AND • the timer to keep the EthSwtPort in ETH_MODE_ACTIVE (see EthIfPortStartupActiveTime) is not running and the EthSwtPort has not been requested with ETH_MODE_ACTIVE If EthIf detects that the requested mode and / or requested link state has not reached, EthIf shall re-trigger the requested mode and link state, respectively.⌋ Note: 1. This shall ensure to re-trigger a wake-up on the network, if e.g. OA TC10 compliant hardware is used (see [5, OPEN Sleep/Wake-up Specification for Automotive Ethernet]). 2. Additionally, the check shall not try to re-establish a requested mode if the timer to switch off the EthSwtPort (requested via EthIfSwitchOffPortTimeDelay) or the timer to keep the EthSwtPort active (requested via EthIfPortStartupActiveTime) is running. Switching-off of the Ethernet hardware in an Ethernet switched network after EthIfSwitchOffPortTimeDelay expires, lead to a situation that an Ethernet switch port and the connected Ethernet hardware (PHY) of the link partner are not synchronized. Thus, first the connected PHY will be switched off and after EthIfSwitchOffPortTimeDelay the Ethernet switch port. This is acceptable since the network management has already confirmed to go to sleep. For example, if using OA TC10 compliant Ethernet hardware, the ECU which is connected to the Ethernet switch trigger a Sleep.Request on the network and bring the connected Ethernet switch ports and its own Ethernet hardware to sleep mode, due to the specified OA TC10 synchronized shutdown of the Ethernet hardware. Thus, the ECU that maintain the Ethernet switch may detect a link down on the affected Ethernet switch port, which should be ignored by the EthIf, if the switch-off of the Ethernet switch port was already triggered but not forwarded to the Ethernet switch. [SWS_EthIf_00499] Status: DRAFT Upstream requirements: SRS_Eth_00156 ⌈For EthIfTransceiver where the referenced EthTrcv is acting as a passive communication slave (EthTrcvActAsSlavePassiveEnabled set to TRUE), EthIf shall check for unexpected link down. If an unexpected link down (link state is requested with ETHTRCV_LINK_STATE_ACTIVE, but current link state is ETHTRCV_LINK_STATE_DOWN) lasts as long as specified in EthIfQualifiedUnexptecedLinkDownTime, EthIf shall trigger to release the affected communication channel by calling EthSM_SleepIndication. If an unexpected link down was detected, the EthSM shall immediatedly be indicated via EthSM_TrcvLinkStateChg without considering EthIfQualifiedUnexpectedLinkDownTime.⌋ Note: [SWS_EthIf_00499] should grant that a communication channel that act as an passive communication channel will shutdown even though the communiation master could not transmit a sleep over the network (e.g. hardware failure, unexpected shutdown of the ECU that act as communication master, a.s.o).