Ethernet Interface (EthIf)
Abstracts Ethernet controller and transceiver hardware for upper protocol layers.
Funktionen — Übersicht
void EthIf_Init (const EthIf_ConfigType* CfgPtr);Initializes the Ethernet InterfaceStd_ReturnType EthIf_SetControllerMode (uint8 CtrlIdx, Eth_ModeType CtrlMode);Enables / disables the indexed controller thernet InterfaceStd_ReturnType EthIf_GetControllerMode (uint8 CtrlIdx, Eth_ModeType* CtrlModePtr);Obtains the state of the ind exed controllerStd_ReturnType EthIf_SetTransceiverWakeupMode (uint8 TrcvIdx, EthTrcv_WakeupModeType TrcvWakeupMode);Enables / disables the wake up mode or clear the wake - up reason of the indexed transceiver Tags: atp.Std_ReturnType EthIf_GetTransceiver EthIf_GetTransceiverWakeupModethernetInterface (uint8 TrcvIdx, EthTrcv_WakeupModeType* TrcvWakeupModePtr); ⚠️Returns the wake up mode of the indexed tran sceiver Tags: atp.Std_ReturnType EthIf_CheckWakeup (EcuM_WakeupSourceType WakeupSource);This API request the affected Ethernet hardware to c heck for a signaled wake - up.Std_ReturnType EthIf_GetPhyWakeupReason (uint8 TrcvIdx, EthTrcv_WakeupReasonType* WakeupReasonPtr);Tags: atp.Status=draftStd_ReturnType EthIf_GetSwitchPortWakeupReason (uint8 SwitchIdx, uint8 SwitchPortIdx, EthTrcv_WakeupReasonType* WakeupReasonPtr);This function obtains the wake up reasons of the indexed Ethernet switch port byvoid EthIf_GetPhysAddr (uint8 CtrlIdx, uint8* PhysAddrPtr);Obtains the physical source address used by the indexed controllervoid EthIf_SetPhysAddr (uint8 CtrlIdx, const uint8* PhysAddrPtr);Sets the physical source address used by the indexed controller.Std_ReturnType EthIf_UpdatePhysAddrFilter (uint8 CtrlIdx, const uint8* PhysAddrPtr, Eth_FilterActionType Action);Update the physical source address to/ from the indexed controller filter.Std_ReturnType EthIf_GetPortMacAddr (const uint8* MacAddrPtr, uint8* SwitchIdxPtr, uint8* PortIdxPtr);Obtains the port over which this MAC - address can be reachedStd_ReturnType EthIf_GetArlTable (uint8 switchIdx, uint16* numberOfElements, Eth_MacVlanType* arlTableListPointer);Obtains the address resolution ta ble of a switch and copies the list into a user provided buffer.Std_ReturnType EthIf_GetCtrlIdxList (uint8* NumberOfCtrlIdx, uint8* CtrlIdxListPtr);Returns the number and index of all active Ethernet controllers.Std_ReturnType EthIf_GetVlan (uint8 CtrlIdx, uint16* VlanIdPtr);Returns the VLAN identifier of the requested Ethernet controller.Std_ReturnType EthIf_GetAndResetMeasurementData (EthIf_MeasurementIdxType MeasurementIdx, boolean MeasurementResetNeeded, uint32* MeasurementDataPtr);Allows to read and reset detailed measurement data for diagnostic purposes.Std_ReturnType EthIf_StoreConfiguration (uint8 SwitchIdx);The function shall request to store the configuration of the learned MAC/ Port tables of a Ethernet switch in a persistent manner.Std_ReturnType EthIf_ResetConfiguration (uint8 SwitchIdx);The function shall request to reset the configuration of the learned MAC/ Port tables of a Eth ernet switch in a persistent...Std_ReturnType EthIf_GetCurrentTime (uint8 CtrlIdx, Eth_TimeStampQualType* timeQualPtr, Eth_TimeStampType* timeStampPtr);Returns a time value out of the HW registers according to the capability of the HW.void EthIf_EnableEgressTimeStamp (uint8 CtrlIdx, Eth_BufIdxType BufIdx thernetInterface); ⚠️Activates egress time stamping on a dedicated message object.Std_ReturnType EthIf_GetEgressTimeStamp (uint8 CtrlIdx, Eth_BufIdxType BufIdx, Eth_TimeStampQualType* timeQualPtr, thernetInterface* timeStampPtr); ⚠️Reads back the egress time stamp on a dedicated message object.Std_ReturnType EthIf_GetIngressTimeStamp (uint8 CtrlIdx, const Eth_DataType* DataPtr, Eth_TimeStampQualType* timeQualPtr, Eth_TimeStampType* timeStampPtr);Reads back the ingress time stamp on a dedicated message object.Std_ReturnType EthIf_SwitchPortGroupRequestMode (EthIf_SwitchPortGroupIdxType PortGroupIdx, Eth_ModeType PortMode);Request a mode for the Eth If Swt Port Group.Std_ReturnType EthIf_StartAllPorts (void);Request to set all configured and affected Eth Swt Ports to ETH_ MODE_ ACTIVEStd_ReturnType EthIf_SetSwitchMgmtInfo (uint8 CtrlIdx, Eth_BufIdxType BufIdx, EthSwt_MgmtInfoType* MgmtInfoPtr);Provides additional management information along to an Ethernet frame that requires special treatment within the Switch.Std_ReturnType EthIf_GetRxMgmtObject (uint8 CtrlIdx, Eth_DataType* DataPtr, EthSwt_MgmtObjectType* * MgmtObjectPtr);Request the Mgmt Object of the (in this context) unique Data Ptr.Std_ReturnType EthIf_GetTxMgmtObject (uint8 CtrlIdx, Eth_BufIdxType BufIdx, EthSwt_MgmtObjectType* * MgmtObjectPtr);Request the Mgmt Object of the (in this context) unique Buf Idx.Std_ReturnType EthIf_SwitchEnableTimeStamping (uint8 CtrlIdx, Eth_BufIdxType BufIdx, EthSwt_MgmtInfoType* MgmtInfo);Activates egress time stamping on a dedicated message object, addressed by Ctrl Idx and Buf Idx.Std_ReturnType EthIf_VerifyConfig (uint8 SwitchIdx, boolean* Result);Forwarded t o Eth Swt_ Verify Config.Std_ReturnType EthIf_SetForwardingMode (uint8 SwitchIdx, boolean mode);Verifies the Switch Configuration.Std_ReturnType EthIf_GetTrcvSignalQuality (uint8 TrcvIdx, EthIf_SignalQualityResultType* ResultPtr);Retrieves the signal quality of the link of the given Ethernet transceiverStd_ReturnType EthIf_GetSwitchPortSignalQuality (uint8 SwitchIdx, uint8 SwitchPortIdx, EthIf_SignalQualityResultType* ResultPtr);Retrieves the signal quality of the link of the given Ethernet switch portStd_ReturnType EthIf_ClearTrcvSignalQuality (uint8 TrcvIdx);Clear the stored signal quality of the link of the given Ethernet transceiverStd_ReturnType EthIf_ClearSwitchPortSignalQuality (uint8 SwitchIdx, uint8 SwitchPortIdx);Clear the stored signal quality of the link of the given Et hernet switch portStd_ReturnType EthIf_SetPhyTestMode (uint8 TrcvIdx, EthTrcv_PhyTestModeType Mode);Activates a given test mode.Std_ReturnType EthIf_SetPhyLoopbackMode (uint8 TrcvIdx, EthTrcv_PhyLoopbackModeType Mode);Activates a given loopback mode.Std_ReturnType EthIf_SetPhyTxMode (uint8 TrcvIdx, EthTrcv_PhyTxModeType Mode);Activates a given transmission mode.Std_ReturnType EthIf_GetCableDiagnosticsResult (uint8 TrcvIdx, EthTrcv_CableDiagResultType* ResultPtr);Retrieves the cable diagnostics result of a given transceiver.Std_ReturnType EthIf_GetPhyIdentifier (uint8 TrcvIdx, uint32* OrgUniqueIdPtr, uint8* ModelNrPtr, uint8* RevisionNrPtr);Obtains the PHY identifier of the Ethernet Interface according to IEEE 802.Std_ReturnType EthIf_GetBufWRxParams (uint8 CtrlIdx, const WEth_BufWRxParamIdType* RxParamIds, uint32* ParamValues, uint8 NumParams);Read out values related to the receive direction of the transceiver for a received packet.Std_ReturnType EthIf_GetBufWTxParams (uint8 CtrlIdx, const WEth_BufWTxParamIdType* TxParamIds, uint32* ParamValues, uint8 NumParams);Read out values related to the transmit direction of the transceiver for a transmitted packet.Std_ReturnType EthIf_SetBufWTxParams (uint8 CtrlIdx, Eth_BufIdxType BufIdx, const WEth_BufWTxParamIdType* TxParamIds, const uint32* ParamValues, uint8 NumParams);Set values related to the transmit direction of the transceiver for a specific buffer (packet to be sent).Std_ReturnType EthIf_SetRadioParams (uint8 TrcvId, const WEthTrcv_SetRadioParamIdType* ParamIds, const uint32* ParamValue, uint8 NumParams);Set values related to a transceiver's wireless radio.Std_ReturnType EthIf_SetChanRxParams (uint8 TrcvId, uint8 RadioId, const WEthTrcv_SetChanRxParamIdType* ParamIds, const uint32* ParamValues, uint8 NumParams);Set values related to the receive direction of a transceiver's wireless channel.Std_ReturnType EthIf_SetChanTxParams (uint8 TrcvId, uint8 RadioId, const WEthTrcv_SetChanTxParamIdType* TxParamIds, const uint32* ParamValues, uint8 NumParams);Set values related to the transmit direction of a transceiver's wireless channel.Std_ReturnType EthIf_GetChanRxParams (uint8 TrcvId, uint8 RadioId, const WEthTrcv_GetChanRxParamIdType* ParamIds, thernetInterface uint32* ParamValues, uint8 NumParams); ⚠️Read values related to the receive direction of the transceiver.BufReq_ReturnType EthIf_ProvideTxBuffer (uint8 CtrlIdx, Eth_FrameType FrameType, uint8 Priority, Eth_BufIdxType* BufIdxPtr, uint8* * BufPtr, uint16* LenBytePtr);Provides access to a transmit buffer of the specified Ethernet controller.Std_ReturnType EthIf_Transmit (uint8 CtrlIdx, Eth_BufIdxType BufIdx, Eth_FrameType FrameType, boolean TxConfirmation, uint16 LenByte, const uint8* PhysAddrPtr);Triggers transmission of a previously filled transmit buffervoid EthIf_GetVersionInfo (Std_VersionInfoType* VersionInfoPtr);Returns the version information of this moduleStd_ReturnType EthIf_GetSwitchPortMode (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_ModeType* PortModePtr);Obtains the mode of the indexed switch portStd_ReturnType EthIf_GetTransceiverMode (uint8 TrcvIdx, Eth_ModeType* TrcvModePtr);Obtains the state of the indexed transceiverStd_ReturnType EthIf_SwitchPortGetLinkState (uint8 SwitchIdx, uint8 SwitchPortIdx, EthTrcv_LinkStateType* LinkStatePtr);Obtains the link state of the indexed switch portStd_ReturnType EthIf_TransceiverGetLinkState (uint8 TrcvIdx, EthTrcv_LinkStateType* LinkStatePtr);Obta ins the link state of the indexed transceiverStd_ReturnType EthIf_SwitchPortGetBaudRate (thernetInterface uint8 SwitchIdx, uint8 SwitchPortIdx, EthTrcv_BaudRateType* BaudRatePtr); ⚠️Obtains the baud rate of the indexed switch portStd_ReturnType EthIf_TransceiverGetBaudRate (uint8 TrcvIdx, EthTrcv_BaudRateType* BaudRatePtr);Obtains the baud rate of the indexed transceiverStd_ReturnType EthIf_SwitchPortGetDuplexMode (uint8 SwitchIdx, uint8 SwitchPortIdx, EthTrcv_DuplexModeType* DuplexModePtr);Obtains the duplex mode of the indexed switch portStd_ReturnType EthIf_TransceiverGetDuplexMode (uint8 TrcvIdx, EthTrcv_DuplexModeType* DuplexModePtr);Obtains the duplex mode of the indexed tra nsceiverStd_ReturnType EthIf_SwitchPortGetCounterValues (uint8 SwitchIdx, thernetInterface uint8 SwitchPortIdx, Eth_CounterType* CounterPtr); ⚠️Reads a list with drop counter values of the corresponding port of the switch.Std_ReturnType EthIf_SwitchPortGetRxStats (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_RxStatsType* RxStatsPtr);Returns a list of statistic counters defined with E th_ Rx Tats Type.Std_ReturnType EthIf_SwitchPortGetTxStats (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_TxStatsType* TxStatsPtr);Returns the list of Transmission Statistics out of IETF RFC1213 defined with Eth_ Tx Stats Type, where the maximal possible...Std_ReturnType EthIf_SwitchPortGetTxErrorCounterValues (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_TxErrorCounterValuesType* TxStatsPtr);Returns the list of Transmission Error Counters out of IETF RFC1213 and RFC16 defined with Eth_ Tx Error Counter Values Type,...Std_ReturnType EthIf_SwitchPortGetMacLearningMode (thernetInterface uint8 SwitchIdx, uint8 SwitchPortIdx, EthSwt_MacLearningType* MacLearningModePtr); ⚠️Returns the MAC learning mode, i.Std_ReturnType EthIf_GetSwitchPortIdentifier (uint8 SwitchIdx, uint8 SwitchPortIdx, uint32* OrgUniqueIdPtr, uint8* ModelNrPtr, uint8* RevisionNrPtr);This function retrieves the OUI (24 bit) of the indexed Ethernet switch port.Std_ReturnType EthIf_GetSwitchIdentifier (uint8 SwitchIdx, uint32* OrgUniqueIdPtr);Obtain the Organizationally Unique Identifier that is given by the IEEE of the indexed Ethernet switch.Std_ReturnType EthIf_WritePortMirrorConfiguration (uint8 MirroredSwitchIdx, const EthSwt_PortMirrorCfgType* PortMirrorConfigurationPtr);Service EthIf_WritePortMirrorConfiguration.Std_ReturnType EthIf_ReadPortMirrorConfiguration (uint8 MirroredSwitchIdx, EthSwt_PortMirrorCfgType* PortMirrorConfigurationPtr);Obtain the port mirror configuration of the given Ethernet switch.Std_ReturnType EthIf_DeletePortMirrorConfiguration (uint8 MirroredSwitchIdx);Delete the stored port mirror configuration of the given Mirrored Switch Idx.Std_ReturnType EthIf_GetPortMirrorState (uint8 SwitchIdx, uint8 PortIdx, EthSwt_PortMirrorStateType* PortMirrorStatePtr);Obtain the current status of the port mirroring for the indexed Ethernet switch portStd_ReturnType EthIf_SetPortMirrorState (uint8 MirroredSwitchIdx, uint8 PortIdx, EthSwt_PortMirrorStateType PortMirrorState);Request to set the given port mirroring state of the port mirror configuration for the given Ethernet switch.Std_ReturnType EthIf_SetPortTestMode (uint8 SwitchIdx, uint8 PortIdx, EthTrcv_PhyTestModeType Mode);Activates a given test mode of the indexed Ethernet switch port.Std_ReturnType EthIf_SetPortLoopbackMode (uint8 SwitchIdx, uint8 PortIdx, EthTrcv_PhyLoopbackModeType Mode);Activates a given test loop - back mode of the indexed Ethernet switch port.Std_ReturnType EthIf_SetPortTxMode (thernetInterface uint8 SwitchIdx, uint8 PortIdx, EthTrcv_PhyTxModeType Mode); ⚠️Activates a given transmission mode of the indexed Ethernet switch port.Std_ReturnType EthIf_GetPortCableDiagnosticsResult (uint8 SwitchIdx, uint8 PortIdx, EthTrcv_CableDiagResultType* ResultPtr);Retrieves the cable diagnostics result of the indexed Ethernet switch port respectively the referenced Ethernet Transceiver...Std_ReturnType EthIf_RunPortCableDiagnostic (uint8 SwitchIdx, uint8 PortIdx);Trigger the cable diagnostics of the given Ethernet Switch port (Port Idx) by calling Eth Trcv_ Run Cable Diagnostic of the...Std_ReturnType EthIf_RunCableDiagnostic (uint8 TrcvIdx);Trigger the cable diagnostics for the given Ethernet transceiver.Std_ReturnType EthIf_SwitchGetCfgDataRaw (uint8 SwitchIdx, uint32 Offset, uint16 Length, uint8* BufferPtr);Retrieves the data in memory of the indexed Ethernet switch in variable lengthStd_ReturnType EthIf_SwitchGetCfgDataInfo (uint8 SwitchIdx, uint32* DataSizePtr, uint32* DataAdressPtr);Retrieves the total size of data and the memory start address of the indexed Ethernet Switch.Std_ReturnType EthIf_SwitchPortGetMaxFIFOBufferFill EthIf_SwitchPortGetMaxFIFOBufferFillLevel (uint8 SwitchPortIdx, uint8 PortIdx, uint8 SwitchPortEgressFifoIdx, uint32* SwitchPortEgressFifoBufferLevelPtr); ⚠️Service EthIf_SwitchPortGetMaxFIFOBufferFillLevel.Std_ReturnType EthIf_TransceiverGetMacMethod (uint8* TrcvIdx, EthTrcv_MacMethodType* MacModePtr);Obtains the media access mode of the transceiver.void EthIf_RxIndication (uint8 CtrlIdx, Eth_FrameType FrameType, boolean IsBroadcast, const uint8* PhysAddrPtr, const Eth_DataType* DataPtr, uint16 LenByte);Handles a received frame received by the indexed controllervoid EthIf_TxConfirmation (uint8 CtrlIdx, Eth_BufIdxType BufIdx, Std_ReturnType Result);Confirms frame transmission by the indexed controllervoid EthIf_CtrlModeIndication (uint8 CtrlIdx, thernetInterface Eth_ModeType CtrlMode); ⚠️Called asynchronously when mode has been read out.void EthIf_TrcvModeIndication (uint8 TrcvIdx, Eth_ModeType TrcvMode);Called asynchronously when a mode change has been read out.void EthIf_SwitchPortModeIndication (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_ModeType PortMode);The Eth If shall determine the expected notifications based on the Eth Swt Port configuration.void EthIf_SleepIndication (uint8 TrcvIdx);This API is called by the corresponding Eth Trcv, if a sleep indication was detected on the network.void EthIf_MainFunctionRx (void);The function checks for new received frames and issues reception indications in polling mode.void EthIf_MainFunctionTx (void);The function issues transmission confirmations in polling mode.void EthIf_MainFunctionState (void);The function is polling different communication hardware (Ethernet transceiver, Ethernet switch ports) related information, e.
Typen — Übersicht
struct EthIf_ConfigTypeImplementation specific structure of the post build configurationEthIf_SwitchPortGroupIdxTypeData Type that represents the Ethernet interface switch port group index.EthIf_MeasurementIdxTypeIndex to select specific measurement dataenum EthIf_SignalQualityResultType-
Funktionen & Typen — Detailansicht
फ़ंक्शन EthIf_Init [SWS_EthIf_00024] 📄 PDF
void EthIf_Init (const EthIf_ConfigType* CfgPtr);
Initializes the Ethernet Interface
उपयोग और सिमेंटिक्स
फ़ंक्शन EthIf_Init ईथरनेट इंटरफ़ेस मॉड्यूल ([SWS_EthIf_00024]) को प्रारंभ करता है। यह सिंक्रोनस रूप से निष्पादित होता है, नॉन-रीएंट्रेंट (Non Reentrant) है और सर्विस-ID 0x01 के साथ हेडर फ़ाइल EthIf.h के माध्यम से उपलब्ध है। एकमात्र पासिंग पैरामीटर के रूप में, फ़ंक्शन पॉइंटर CfgPtr की अपेक्षा करता है, जो EthIf_ConfigType प्रकार के कार्यान्वयन-विशिष्ट कॉन्फ़िगरेशन संरचना को संदर्भित करता है। इसमें न तो इनपुट-आउटपुट और न ही आउटपुट पैरामीटर हैं, और फ़ंक्शन का कोई रिटर्न मान नहीं है ([SWS_EthIf_00024])।
समवर्तीता और कॉल संदर्भ
चूँकि EthIf_Init रीएंट्रेंट नहीं है, इसलिए कोई समवर्ती या नेस्टेड कॉल नहीं होना चाहिए [SWS_EthIf_00024]। चूँकि पेलोड में विशिष्ट कॉल संदर्भ का विस्तार से वर्णन नहीं किया गया है, इसलिए संभवतः यह कॉल अन्य ईथरनेट सेवाओं का लाभ उठाने से पहले ECU के इनिशियलाइज़ेशन अनुक्रम के दौरान आम तौर पर एक बार होगी। प्रश्न Q-07e92f9f3c15ea5b (खुला)
अनुक्रम शर्तें और पारस्परिक क्रिया
EthIf_Init का कॉल मॉड्यूल के अन्य सभी फ़ंक्शनों के उपयोग के लिए एक अनिवार्य पूर्व-आवश्यकता है। यदि विकास त्रुटि पहचान (Development Error Detection) सक्रिय है, तो ईथरनेट इंटरफ़ेस की कई सेवाएँ अपने निष्पादन से पहले जाँचती हैं कि क्या EthIf_Init पहले कॉल किया गया था:
- यदि इनिशियलाइज़ेशन नहीं किया गया था, तो निर्भर फ़ंक्शन विकास त्रुटि
ETHIF_E_UNINITकी रिपोर्ट करते हैं (उदाहरण के लिए [SWS_EthIf_00155], [SWS_EthIf_00161], [SWS_EthIf_00167], [SWS_EthIf_00173], [SWS_EthIf_00193], [SWS_EthIf_00199], [SWS_EthIf_00217], [SWS_EthIf_00222], [SWS_EthIf_00299], [SWS_EthIf_00302] और [SWS_EthIf_00304])। - इनिशियलाइज़ेशन न होने पर कई इंटरफ़ेस निष्पादन रद्द कर देते हैं और अतिरिक्त रूप से त्रुटि मान
E_NOT_OKलौटाते हैं (जैसे [SWS_EthIf_00246], [SWS_EthIf_00273] तथा [SWS_EthIf_00277])।
यह उपयोग निर्देश स्वचालित रूप से तैयार किया गया था और AUTOSAR Classic R20-11 विशिष्टता पर आधारित है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)
फ़ंक्शन EthIf_SetControllerMode [SWS_EthIf_00034] 📄 PDF
Std_ReturnType EthIf_SetControllerMode (uint8 CtrlIdx, Eth_ModeType CtrlMode);
Enables / disables the indexed controller thernet Interface AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_EthernetInterface
उपयोग
फ़ंक्शन EthIf_SetControllerMode ईथरनेट इंटरफ़ेस के संदर्भ में CtrlIdx के माध्यम से निर्दिष्ट ईथरनेट कंट्रोलर को सक्रिय या निष्क्रिय करता है [SWS_EthIf_00034]। पैरामीटर CtrlMode के माध्यम से निम्नलिखित स्थितियों का अनुरोध किया जाता है [SWS_EthIf_00034]:
ETH_MODE_DOWN: नियंत्रक को निष्क्रिय करता है।ETH_MODE_ACTIVE: कंट्रोलर को सक्रिय करता है।ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST: कंट्रोलर को सक्रिय करता है और नेटवर्क पर वेक-अप का अनुरोध करता है।
फ़ंक्शन एसिंक्रोनस रूप से कार्य करता है [SWS_EthIf_00034]। यह सफल निष्पादन पर E_OK लौटाता है या E_NOT_OK यदि कंट्रोलर मोड को बदला नहीं जा सका [SWS_EthIf_00034]।
इंटरैक्शन और फ़ॉरवर्डिंग
यदि किसी कंट्रोलर के लिए ETH_MODE_ACTIVE के साथ EthIf_SetControllerMode कॉल किया जाता है, जो “control” प्रकार के EthIfSwitchPortGroup को संदर्भित करता है, तो EthIf इस कॉल को समूह के सभी पोर्ट्स पर अग्रेषित करता है, बशर्ते कि इस मोड का पोर्ट के लिए पहली बार अनुरोध किया गया हो और इसकी स्थिति ETH_MODE_DOWN हो। इस प्रक्रिया में ETH_MODE_ACTIVE के साथ EthSwt_SetSwitchPortMode और ETHTRCV_LINK_STATE_ACTIVE के साथ EthSwt_PortLinkStateRequest एक के बाद एक निष्पादित किए जाते हैं [SWS_EthIf_00264]।
ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST के अनुरोध पर, EthIf वर्तमान मोड की परवाह किए बिना कॉल को निम्नानुसार अग्रेषित करता है:
EthIfTransceiverके संदर्भ के मामले में:ETH_MODE_ACTIVE_WITH_WAKEUP_REQUESTके साथEthTrcv_SetTransceiverModeको कॉल करना और उसके बादETHTRCV_LINK_STATE_ACTIVEके साथEthTrcv_TransceiverLinkStateRequest, यदि वर्तमान स्थितिETHTRCV_LINK_STATE_DOWNहै [SWS_EthIf_00479]।EthIfSwitchअथवा “control” प्रकार केEthIfSwitchPortGroupके संदर्भ के मामले में:ETH_MODE_ACTIVE_WITH_WAKEUP_REQUESTके साथEthSwt_SetSwitchPortModeको कॉल करना और उसके बादETHTRCV_LINK_STATE_ACTIVEके साथEthSwt_PortLinkStateRequest, यदि वर्तमान स्थितिETHTRCV_LINK_STATE_DOWNहै [SWS_EthIf_00480], [SWS_EthIf_00481]।
प्रतिबंध
फ़ंक्शन नॉन-रीएंट्रेंट (Non Reentrant) है और EthIf.h के माध्यम से उपलब्ध है [SWS_EthIf_00034]।
यह उपयोग नोट विनिर्देश AUTOSAR CP R20-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)
फ़ंक्शन EthIf_GetControllerMode [SWS_EthIf_00039] 📄 PDF
Std_ReturnType EthIf_GetControllerMode (uint8 CtrlIdx, Eth_ModeType* CtrlModePtr);
Obtains the state of the ind exed controller
फ़ंक्शन EthIf_SetTransceiverWakeupMode [SWS_EthIf_00233] 📄 PDF
Std_ReturnType EthIf_SetTransceiverWakeupMode (uint8 TrcvIdx, EthTrcv_WakeupModeType TrcvWakeupMode);
Enables / disables the wake up mode or clear the wake - up reason of the indexed transceiver Tags: atp.Status=obsolete
सिंक्रोनस और नॉन-रीएंट्रेंट फ़ंक्शन EthIf_SetTransceiverWakeupMode (सर्विस ID 0x2e) Ethernet Interface में TrcvIdx के माध्यम से एड्रेस किए गए ट्रांसीवर का वेक-अप मोड सेट करने या उसके वेक-अप कारण को रीसेट करने का कार्य करता है [SWS_EthIf_00233]। यह फ़ंक्शन हेडर फ़ाइल EthIf.h में घोषित है और AUTOSAR CP R20-11 रिलीज़ में अप्रचलित (obsolete) के रूप में चिह्नित है [SWS_EthIf_00233]।
नियंत्रण पासिंग पैरामीटर TrcvWakeupMode के माध्यम से होता है [SWS_EthIf_00233]:
ETHTRCV_WUM_ENABLE: ट्रांसीवर के वेक-अप को सक्रिय करता है [SWS_EthIf_00233]। यदि संबद्ध ड्राइवरEthIfTransceiverIdxवर्तमान मेंETHTRCV_WUM_DISABLEस्थिति में है, तो कॉलEthTrcv_SetTransceiverWakeupModeको अग्रेषित की जाती है [SWS_EthIf_00234]।ETHTRCV_WUM_DISABLE: ट्रांसीवर के वेक-अप को निष्क्रिय करता है [SWS_EthIf_00233]। यदि ड्राइवर की वर्तमान स्थितिETHTRCV_WUM_ENABLEहै, तो फ़ंक्शन कॉल कोEthTrcv_SetTransceiverWakeupModeको अग्रेषित करता है [SWS_EthIf_00268]।ETHTRCV_WUM_CLEAR: इंडेक्स किए गए ट्रांसीवर के वेक-अप कारण को साफ़ करता है [SWS_EthIf_00233]।
रिटर्न मान के रूप में, यह कॉल सफल निष्पादन पर E_OK लौटाती है या E_NOT_OK लौटाती है यदि वेक-अप मोड बदला नहीं जा सका या वेक-अप कारण साफ़ नहीं किया जा सका [SWS_EthIf_00233]। चूँकि इंटरफ़ेस नॉन-रीएंट्रेंट के रूप में परिभाषित है, समवर्ती कॉल अस्वीकार्य हैं [SWS_EthIf_00233]।
यह उपयोग निर्देश AUTOSAR CP R20-11 विनिर्देश के आधार पर स्वचालित रूप से तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_GetTransceiverWakeupModethernetInterface [SWS_EthIf_00238] 📄 PDF
Std_ReturnType EthIf_GetTransceiverWakeupMode (uint8 TrcvIdx, EthTrcv_WakeupModeType* TrcvWakeupModePtr);
Returns the wake up mode of the indexed tran sceiver Tags: atp.Status=obsolete
फ़ंक्शन EthIf_CheckWakeup [SWS_EthIf_00244] 📄 PDF
Std_ReturnType EthIf_CheckWakeup (EcuM_WakeupSourceType WakeupSource);
This API request the affected Ethernet hardware to c heck for a signaled wake - up. The used Ethernet hardware could be an Ethernet switch or Ethernet transceiver (PHY). This is used e.g. for Ethernet hardware which is compliant to the specification of Open Alliance TC10. This API is called by the integration code. The function could be called in context of the interrupt or on task level.
फ़ंक्शन EthIf_CheckWakeup संबंधित ईथरनेट हार्डवेयर से संकेतित वेक-अप की जाँच करने का अनुरोध करता है [SWS_EthIf_00244]। इसका उपयोग, उदाहरण के लिए, ऐसे ईथरनेट हार्डवेयर के लिए किया जाता है जो OPEN Alliance TC10 विनिर्देश के अनुरूप है [SWS_EthIf_00244]। यह कॉल इंटीग्रेशन कोड द्वारा एसिंक्रोनस और रीएंट्रेंट रूप से किया जाता है, वैकल्पिक रूप से किसी इंटरप्ट के संदर्भ में या टास्क स्तर पर [SWS_EthIf_00244]।
इनपुट पैरामीटर के रूप में EcuM_WakeupSourceType प्रकार का WakeupSource उपयोग किया जाता है, जो ट्रिगर करने वाले स्रोत डिवाइस (ईथरनेट ट्रांसीवर या ईथरनेट स्विच) को निर्दिष्ट करता है [SWS_EthIf_00244]। यदि हार्डवेयर को दिया गया जाँच अनुरोध स्वीकार कर लिया गया था, तो रिटर्न वैल्यू E_OK होती है, अन्यथा अनुरोध अस्वीकार होने पर E_NOT_OK होती है [SWS_EthIf_00244]। मॉड्यूल इस कॉल को आंतरिक रूप से निचले स्तर के ड्राइवर्स को अग्रेषित करता है:
- सभी संबंधित ईथरनेट ट्रांसीवरों (
EthIfTransceiverयाEthIfSwitchPortGroupsके माध्यम से संदर्भित) के लिए, संबंधित ट्रांसीवर ड्राइवर केEthTrcv_CheckWakeupको कॉल किया जाता है [SWS_EthIf_00245]। - सभी संबंधित ईथरनेट स्विचों (
EthIfSwitchके माध्यम से संदर्भित) के लिए, संबंधित स्विच ड्राइवर केEthSwt_SwitchCheckWakeupको कॉल किया जाता है [SWS_EthIf_00500]।
EthIf_CheckWakeup की उपलब्धता को प्री-कंपाइल समय पर कॉन्फ़िगरेशन पैरामीटर EthIfWakeUpSupport के माध्यम से सक्षम और अक्षम किया जा सकता है [SWS_EthIf_00248]। API हेडर EthIf.h [SWS_EthIf_00244] के माध्यम से प्रदान की जाती है।
यह उपयोग नोट AUTOSAR विनिर्देश R20-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_GetPhyWakeupReason [SWS_EthIf_91004] 📄 PDF
Std_ReturnType EthIf_GetPhyWakeupReason (uint8 TrcvIdx, EthTrcv_WakeupReasonType* WakeupReasonPtr);
Tags: atp.Status=draft
फ़ंक्शन EthIf_GetSwitchPortWakeupReason [SWS_EthIf_00488] 📄 PDF
Std_ReturnType EthIf_GetSwitchPortWakeupReason (uint8 SwitchIdx, uint8 SwitchPortIdx, EthTrcv_WakeupReasonType* WakeupReasonPtr);
This function obtains the wake up reasons of the indexed Ethernet switch port by
फ़ंक्शन EthIf_GetPhysAddr [SWS_EthIf_00061] 📄 PDF
void EthIf_GetPhysAddr (uint8 CtrlIdx, uint8* PhysAddrPtr);
Obtains the physical source address used by the indexed controller
फ़ंक्शन EthIf_SetPhysAddr [SWS_EthIf_00132] 📄 PDF
void EthIf_SetPhysAddr (uint8 CtrlIdx, const uint8* PhysAddrPtr);
Sets the physical source address used by the indexed controller.
फ़ंक्शन EthIf_UpdatePhysAddrFilter [SWS_EthIf_00139] 📄 PDF
Std_ReturnType EthIf_UpdatePhysAddrFilter (uint8 CtrlIdx, const uint8* PhysAddrPtr, Eth_FilterActionType Action);
Update the physical source address to/ from the indexed controller filter. If the Ethernet Controller is not capable to do the filtering, the software has to do this.
तुल्यकालिक फ़ंक्शन EthIf_UpdatePhysAddrFilter ([SWS_EthIf_00139]) CtrlIdx के माध्यम से निर्दिष्ट ईथरनेट नियंत्रक के लिए एड्रेस फ़िल्टर को अपडेट करने का काम करता है। पैरामीटर Action (प्रकार Eth_FilterActionType का) के माध्यम से एक भौतिक पता फ़िल्टर में जोड़ा जाता है या उससे हटाया जाता है।
कॉन्फ़िगरेशन के लिए PhysAddrPtr नेटवर्क बाइट क्रम में भौतिक MAC पते के लिए एक पॉइंटर की अपेक्षा करता है, जो लेयर-2 ईथरनेट पैकेट के मल्टीकास्ट गंतव्य पते का प्रतिनिधित्व करता है [SWS_EthIf_00139]। यद्यपि शाब्दिक फ़ंक्शन विवरण स्रोत पते की बात करता है, यह संभवतः एक संपादकीय चूक है, क्योंकि पैरामीटर विनिर्देश अनिवार्य रूप से मल्टीकास्ट गंतव्य पता निर्धारित करता है। प्रश्न Q-312e20e5eadda94a (खुला)
प्रक्रिया और सीमाओं के संबंध में निम्नलिखित विनिर्देश लागू होते हैं [SWS_EthIf_00139]:
- रिटर्न मान: फ़ंक्शन
E_OKलौटाता है यदि फ़िल्टर कॉन्फ़िगरेशन सफलतापूर्वक बदल दिया गया था, याE_NOT_OKयदि परिवर्तन विफल रहा। विशिष्ट DET या DEM त्रुटि कोड स्रोतों में परिभाषित नहीं हैं। - हार्डवेयर समर्थन: यदि अंतर्निहित ईथरनेट नियंत्रक हार्डवेयर स्तर पर फ़िल्टरिंग करने में सक्षम नहीं है, तो सॉफ़्टवेयर को इस फ़िल्टरिंग कार्य को संभालना होगा।
- समवर्तीता: कॉल उसी नियंत्रक सूचकांक (
CtrlIdx) के लिए गैर-पुनःप्रवेशी है, लेकिन विभिन्न नियंत्रकों के लिए समवर्ती रूप से निष्पादित की जा सकती है।
यह उपयोग नोट एक AI द्वारा विनिर्देश R20-11 के आधार पर जनरेट किया गया था।
फ़ंक्शन EthIf_GetPortMacAddr [SWS_EthIf_00190] 📄 PDF
Std_ReturnType EthIf_GetPortMacAddr (const uint8* MacAddrPtr, uint8* SwitchIdxPtr, uint8* PortIdxPtr);
Obtains the port over which this MAC - address can be reached
फ़ंक्शन EthIf_GetArlTable [SWS_EthIf_00196] 📄 PDF
Std_ReturnType EthIf_GetArlTable (uint8 switchIdx, uint16* numberOfElements, Eth_MacVlanType* arlTableListPointer);
Obtains the address resolution ta ble of a switch and copies the list into a user provided buffer. The function will copy all or number Of
फ़ंक्शन EthIf_GetCtrlIdxList [SWS_EthIf_91053] 📄 PDF
Std_ReturnType EthIf_GetCtrlIdxList (uint8* NumberOfCtrlIdx, uint8* CtrlIdxListPtr);
Returns the number and index of all active Ethernet controllers.
फ़ंक्शन EthIf_GetVlan [SWS_EthIf_91052] 📄 PDF
Std_ReturnType EthIf_GetVlanId (uint8 CtrlIdx, uint16* VlanIdPtr);
Returns the VLAN identifier of the requested Ethernet controller.
फ़ंक्शन EthIf_GetAndResetMeasurementData [SWS_EthIf_91011] 📄 PDF
Std_ReturnType EthIf_GetAndResetMeasurementData (EthIf_MeasurementIdxType MeasurementIdx, boolean MeasurementResetNeeded, uint32* MeasurementDataPtr);
Allows to read and reset detailed measurement data for diagnostic purposes. Get all Measurement Idx's at once is not supported. ETHIF_ MEAS_ ALL shall only be used to reset all Measurement Idx's at once. A NULL_ PTR shall be provided for Measurement Data Ptr in this case.
फ़ंक्शन EthIf_StoreConfiguration [SWS_EthIf_00214] 📄 PDF
Std_ReturnType EthIf_StoreConfiguration (uint8 SwitchIdx);
The function shall request to store the configuration of the learned MAC/ Port tables of a Ethernet switch in a persistent manner. This could be used by e.g. a CDD.
उपयोग और कॉल संदर्भ
फ़ंक्शन EthIf_StoreConfiguration का उपयोग ईथरनेट स्विच की सीखी गई MAC/पोर्ट तालिकाओं के स्थायी भंडारण का अनुरोध करने के लिए किया जाता है [SWS_EthIf_00214]। एक विशिष्ट कॉलर के रूप में, उदाहरण के लिए, एक Complex Device Driver (CDD) का उल्लेख किया गया है [SWS_EthIf_00214]। इंटरफ़ेस हेडर फ़ाइल EthIf.h के माध्यम से सुलभ है और सर्विस-ID 0x2c रखता है [SWS_EthIf_00214]।
इनपुट पैरामीटर SwitchIdx के माध्यम से ईथरनेट स्विच ड्राइवर के संदर्भ में लक्षित स्विच का इंडेक्स पास किया जाता है [SWS_EthIf_00214]। रिटर्न मान के रूप में, फ़ंक्शन स्थिति Std_ReturnType लौटाता है: मान E_OK इंगित करता है कि भंडारण अनुरोध स्वीकार कर लिया गया था, जबकि E_NOT_OK गैर-स्वीकृति का संकेत देता है [SWS_EthIf_00214]। चूँकि विनिर्देश निष्पादन को तुल्यकालिक/अतुल्यकालिक के रूप में चिह्नित करता है, अनुरोध की स्वीकृति संभवतः तुल्यकालिक रूप से होती है, जबकि वास्तविक स्थायित्व (persisting) संभवतः अनुवर्ती मॉड्यूल में अतुल्यकालिक रूप से प्रबंधित किया जाता है। प्रश्न Q-4f10e936c7d30258 (खुला)
प्रतिबंध और त्रुटि प्रबंधन
समवर्तीता के संबंध में, EthIf_StoreConfiguration को गैर-पुनःप्रवेशी (Non Reentrant) के रूप में निर्दिष्ट किया गया है [SWS_EthIf_00214]। इसलिए समानांतर कॉलों को कॉलर पक्ष पर टाला जाना चाहिए या सिंक्रनाइज़ किया जाना चाहिए। इस इंटरफ़ेस के लिए विशिष्ट DET या DEM त्रुटि संदेश परिभाषित नहीं हैं; अनुरोध स्वीकृति में विफलता केवल रिटर्न मान E_NOT_OK के माध्यम से रिपोर्ट की जाती है [SWS_EthIf_00214]।
यह उपयोग नोट स्वचालित रूप से तैयार किया गया था। स्रोत दस्तावेज़ों में परिवर्तन होने पर इसे पुनः जनरेट किया जाएगा।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_ResetConfiguration [SWS_EthIf_00219] 📄 PDF
Std_ReturnType EthIf_ResetConfiguration (uint8 SwitchIdx);
The function shall request to reset the configuration of the learned MAC/ Port tables of a Eth ernet switch in a persistent manner. This could be used by e.g. a CDD. The statically configured entries shall still remain.
उपयोग और कॉल संदर्भ
फ़ंक्शन EthIf_ResetConfiguration का उपयोग ईथरनेट स्विच की गतिशील रूप से सीखी गई MAC और पोर्ट तालिकाओं के स्थायी रीसेट का अनुरोध करने के लिए किया जाता है [SWS_EthIf_00219]। स्थिर रूप से कॉन्फ़िगर की गई प्रविष्टियाँ कॉन्फ़िगरेशन में अपरिवर्तित रहती हैं [SWS_EthIf_00219]। इस इंटरफ़ेस के कॉलर के रूप में, उदाहरण के लिए, एक Complex Device Driver (CDD) कार्य कर सकता है [SWS_EthIf_00219]।
ट्रांसफ़र पैरामीटर SwitchIdx के माध्यम से ईथरनेट स्विच ड्राइवर के संदर्भ में संबंधित स्विच का इंडेक्स निर्दिष्ट किया जाता है [SWS_EthIf_00219]। निष्पादन सिमेंटिक्स के संबंध में, ऑपरेशन को तुल्यकालिक/अतुल्यकालिक के रूप में निर्दिष्ट किया गया है [SWS_EthIf_00219]; इसका संभवतः अर्थ यह है कि अनुरोध की प्राप्ति को तुल्यकालिक रूप से स्वीकार किया जाता है, जबकि हार्डवेयर तालिकाओं का रीसेट अतुल्यकालिक रूप से चलता है। प्रश्न Q-9e7f89ec9e809fd0 (खुला)
रिटर्न मान और त्रुटि प्रबंधन
रिटर्न मान के रूप में, फ़ंक्शन प्रकार Std_ReturnType की स्थिति लौटाता है [SWS_EthIf_00219]:
E_OK: MAC/पोर्ट तालिका को स्थायी रूप से रीसेट करने का अनुरोध सफलतापूर्वक स्वीकार कर लिया गया था [SWS_EthIf_00219]।E_NOT_OK: अनुरोध अस्वीकार कर दिया गया था [SWS_EthIf_00219]।
वर्तमान विनिर्देश दायरे में इस फ़ंक्शन के लिए विशिष्ट DET या DEM त्रुटि संदेश प्रलेखित नहीं हैं।
समवर्तीता और प्रतिबंध
इंटरफ़ेस को गैर-पुनःप्रवेशी (Non Reentrant) के रूप में निर्दिष्ट किया गया है [SWS_EthIf_00219]। इसलिए कॉल करने वालों को यह सुनिश्चित करना होगा कि कोई समवर्ती या बाधित करने वाले कॉल न हों। फ़ंक्शन हेडर फ़ाइल EthIf.h के माध्यम से शामिल किया गया है [SWS_EthIf_00219]।
यह उपयोग नोट AUTOSAR रिलीज़ R20-11 के विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_GetCurrentTime [SWS_EthIf_00154] 📄 PDF
Std_ReturnType EthIf_GetCurrentTime (uint8 CtrlIdx, Eth_TimeStampQualType* timeQualPtr, Eth_TimeStampType* timeStampPtr);
Returns a time value out of the HW registers according to the capability of the HW. Is the HW resolution is lower than the Eth_ Time Stamp Type resolution resp. range, the remaining bits will be filled with 0. Important Note: Eth If_ Get Curren t Time may be called within an exclusive area.
फ़ंक्शन EthIf_EnableEgressTimeStamp [SWS_EthIf_00160] 📄 PDF
void EthIf_EnableEgressTimeStamp (uint8 CtrlIdx, Eth_BufIdxType BufIdx thernetInterface); ⚠️
Activates egress time stamping on a dedicated message object. Some HW does store once the egress time stamp marker and some HW needs it always before transmission. There will be no "disable" functionality, due to the fact, that the message type is always " time stamped" by network design.
सिंक्रोनस फ़ंक्शन EthIf_EnableEgressTimeStamp एक समर्पित संदेश ऑब्जेक्ट या ट्रांसमिट बफर के लिए ट्रांसमिट टाइमस्टैम्प (Egress Time Stamping) के रिकॉर्डिंग को सक्रिय करने का कार्य करता है [SWS_EthIf_00160]। इंटरफ़ेस हेडर फ़ाइल EthIf.h के माध्यम से प्रदान किया जाता है [SWS_EthIf_00160]।
पैरामीटर और कॉल
कॉल करने पर, फ़ंक्शन दो इनपुट पैरामीटर [SWS_EthIf_00160] पास किए जाने की अपेक्षा करता है:
CtrlIdx: संबोधित Ethernet नियंत्रक का इंडेक्स [SWS_EthIf_00160]।BufIdx: संदेश बफर का इंडेक्स, जिस पर एप्लिकेशन ट्रांसमिट टाइमस्टैम्प रिकॉर्ड किए जाने की अपेक्षा करता है [SWS_EthIf_00160]।
फ़ंक्शन का कोई रिटर्न मान (void) नहीं है और न ही कोई इनपुट या आउटपुट पैरामीटर हैं [SWS_EthIf_00160]।
हार्डवेयर व्यवहार और समवर्तीता (कॉनकरेंसी)
हार्डवेयर का व्यवहार नियंत्रक के आधार पर भिन्न होता है: कुछ हार्डवेयर प्रकार एक बार के कॉन्फ़िगरेशन के बाद ट्रांसमिट टाइमस्टैम्प के लिए अंकन को स्थायी रूप से संग्रहीत करते हैं, जबकि अन्य नियंत्रकों को प्रत्येक एकल ट्रांसमिशन से पहले इसकी अनिवार्य रूप से आवश्यकता होती है [SWS_EthIf_00160]। व्याख्या: स्थायी भंडारण के बिना नियंत्रकों पर, फ़ंक्शन को प्रत्येक ट्रांसमिशन प्रक्रिया से पहले एप्लिकेशन द्वारा फिर से कॉल किया जाना चाहिए। प्रश्न Q-e87b424598f8a684 (खुला) विनिर्देश के अनुसार निष्क्रिय करने की कोई संभावना मौजूद नहीं है, क्योंकि संबंधित संदेश प्रकार नेटवर्क डिज़ाइन के अनुसार स्थायी रूप से टाइमस्टैम्प किया जाता है [SWS_EthIf_00160]।
समवर्तीता के संबंध में, फ़ंक्शन को नॉन-रीएंट्रेंट (Non Reentrant) के रूप में परिभाषित किया गया है [SWS_EthIf_00160]।
यह उपयोग निर्देश AUTOSAR R20-11 स्पेसिफिकेशन के आधार पर स्वचालित रूप से जनरेट किया गया था।
फ़ंक्शन EthIf_GetEgressTimeStamp [SWS_EthIf_00166] 📄 PDF
Std_ReturnType EthIf_GetEgressTimeStamp (uint8 CtrlIdx, Eth_BufIdxType BufIdx, Eth_TimeStampQualType* timeQualPtr, thernetInterface* timeStampPtr); ⚠️
Reads back the egress time stamp on a dedicated message object. It must be called within the Tx Confirmation() function.
फ़ंक्शन EthIf_GetIngressTimeStamp [SWS_EthIf_00172] 📄 PDF
Std_ReturnType EthIf_GetIngressTimeStamp (uint8 CtrlIdx, const Eth_DataType* DataPtr, Eth_TimeStampQualType* timeQualPtr, Eth_TimeStampType* timeStampPtr);
Reads back the ingress time stamp on a dedicated message object. It must be called within the Rx Indication() function.
फ़ंक्शन EthIf_SwitchPortGroupRequestMode [SWS_EthIf_91102] 📄 PDF
Std_ReturnType EthIf_SwitchPortGroupRequestMode (EthIf_SwitchPortGroupIdxType PortGroupIdx, Eth_ModeType PortMode);
Request a mode for the Eth If Swt Port Group. The call shall be forwarded to Eth Swt by calling Eth Swt_ Set Switch P ort Mode for all Eth Swt Ports referenced by the port group.
एसिंक्रोनस फ़ंक्शन EthIf_SwitchPortGroupRequestMode किसी स्विच-पोर्ट समूह के लिए एक ऑपरेटिंग मोड का अनुरोध करता है ([SWS_EthIf_91102])। कॉल को नॉन-रीएंट्रेंट के रूप में निर्दिष्ट किया गया है और यह पोर्ट समूह का इंडेक्स (PortGroupIdx) और वांछित लक्ष्य मोड (PortMode) पास करता है। उपलब्ध मोड्स में निष्क्रिय करने के लिए ETH_MODE_DOWN, सक्रिय करने के लिए ETH_MODE_ACTIVE, और नेटवर्क वेक-अप के साथ सक्रिय करने के लिए ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST शामिल हैं ([SWS_EthIf_91102])। सफल आरंभ होने पर फ़ंक्शन E_OK लौटाता है, अन्यथा E_NOT_OK ([SWS_EthIf_91102])।
मूल रूप से, EthIf सभी संदर्भित पोर्ट्स के लिए EthSwt_SetSwitchPortMode को कॉल करके निचले स्तर के स्विच को अनुरोध अग्रेषित करता है ([SWS_EthIf_91102])। इस प्रक्रिया में विभिन्न मोड्स के लिए विशिष्ट व्यवहार नियम लागू होते हैं:
- निष्क्रियीकरण (
ETH_MODE_DOWN): यदि पोर्ट्स वर्तमान मेंETH_MODE_ACTIVEअवस्था में हैं और उन पोर्ट्स को संदर्भित करने वाले सभी समूहों के लिएETH_MODE_DOWNका अनुरोध किया गया है, तोEthIfविलंब समयEthIfSwitchOffPortTimedelayके साथ एक टाइमर प्रारंभ करता है ([SWS_EthIf_00270])। - सक्रियण (
ETH_MODE_ACTIVEयाETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST): संबंधित पोर्ट समूह के पोर्ट्स के लिए चल रहा शटडाउन विलंब टाइमर तुरंत रद्द कर दिया जाता है ([SWS_EthIf_00483])। - वेक-अप अनुरोध (
ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST): वर्तमान पोर्ट मोड की परवाह किए बिना, समूह के सभी पोर्ट्स के लिए कॉल को अनिवार्य रूप से एक निश्चित क्रम में अग्रेषित किया जाता है: पहलेETH_MODE_ACTIVE_WITH_WAKEUP_REQUESTके साथEthSwt_SetSwitchPortModeको कॉल किया जाता है, उसके बादETHTRCV_LINK_STATE_ACTIVEके साथEthSwt_PortLinkStateRequestको कॉल किया जाता है, यदि वर्तमान लिंक स्थितिETHTRCV_LINK_STATE_DOWNहै ([SWS_EthIf_00482])।
इस सेवा के लिए कोई विशिष्ट DET या DEM त्रुटि संदेश सूचीबद्ध नहीं हैं; मोड परिवर्तन की विफलता सीधे रिटर्न मान E_NOT_OK के माध्यम से इंगित की जाती है ([SWS_EthIf_91102])।
यह उपयोग नोट AUTOSAR विनिर्देश R20-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)
फ़ंक्शन EthIf_StartAllPorts [SWS_EthIf_91103] 📄 PDF
Std_ReturnType EthIf_StartAllPorts (void);
Request to set all configured and affected Eth Swt Ports to ETH_ MODE_ ACTIVE
फ़ंक्शन EthIf_StartAllPorts सभी कॉन्फ़िगर किए गए और प्रभावित ईथरनेट स्विच पोर्ट्स को स्थिति ETH_MODE_ACTIVE में लाने का अनुरोध करने के लिए कार्य करता है ([SWS_EthIf_91103])। यह कॉल पैरामीटर रहित है, इसमें एसिंक्रोनस सिमेंटिक्स हैं, और इसे रीएंट्रेंट के रूप में निर्दिष्ट किया गया है ([SWS_EthIf_91103])। रिटर्न वैल्यू के रूप में, E_OK अनुरोध की स्वीकृति का संकेत देता है, जबकि E_NOT_OK अस्वीकृति को दर्शाता है ([SWS_EthIf_91103])।
EthIf_StartAllPorts के कॉल के बाद, EthIf ईथरनेट स्विचों के सभी प्रभावित पोर्ट्स (EthSwtPorts) को एक निश्चित क्रम में नियंत्रण निर्देश अग्रेषित करता है ([SWS_EthIf_00275]):
- सबसे पहले,
ETH_MODE_ACTIVEके साथEthSwt_SetSwitchPortModeको कॉल किया जाता है, यदि वर्तमान मोडETH_MODE_DOWNहै ([SWS_EthIf_00275])। - इसके बाद
ETHTRCV_LINK_STATE_ACTIVEके साथEthSwt_PortLinkStateRequestको कॉल किया जाता है, यदि वर्तमान लिंक स्थितिETHTRCV_LINK_STATE_DOWNहै, और इन सभी पोर्ट्स के लिए समय अंतरालEthIfPortStartupActiveTimeवाला एक टाइमर प्रारंभ किया जाता है ([SWS_EthIf_00275])।
यदि इस प्रकार सक्रिय किया गया कोई पोर्ट समय अंतराल EthIfPortStartupActiveTime के भीतर नियमित रूप से ETH_MODE_ACTIVE के साथ अनुरोधित नहीं किया जाता है, तो EthIf इस पोर्ट को स्वचालित रूप से फिर से निष्क्रिय कर देता है ([SWS_EthIf_00276])। निष्क्रियीकरण अनिवार्य रूप से उल्टे क्रम में होता है:
- सबसे पहले
ETHTRCV_LINK_STATE_DOWNके साथEthSwt_PortLinkStateRequestको कॉल किया जाता है ([SWS_EthIf_00276])। - इसके बाद
ETH_MODE_DOWNके साथEthSwt_SetSwitchPortModeको कॉल किया जाता है ([SWS_EthIf_00276])।
यह उपयोग नोट AUTOSAR क्लासिक प्लेटफ़ॉर्म R20-11 के विनिर्देशों पर आधारित है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SetSwitchMgmtInfo [SWS_EthIf_91003] 📄 PDF
Std_ReturnType EthIf_SetSwitchMgmtInfo (uint8 CtrlIdx, Eth_BufIdxType BufIdx, EthSwt_MgmtInfoType* MgmtInfoPtr);
Provides additional management information along to an Ethernet frame that requires special treatment within the Switch. It has to be called between Eth If_ Provide Tx Buffer() and Eth If_ Transmit() of the related frame.
फ़ंक्शन EthIf_GetRxMgmtObject [SWS_EthIf_91105] 📄 PDF
Std_ReturnType EthIf_GetRxMgmtObject (uint8 CtrlIdx, Eth_DataType* DataPtr, EthSwt_MgmtObjectType* * MgmtObjectPtr);
Request the Mgmt Object of the (in this context) unique Data Ptr.
फ़ंक्शन EthIf_GetTxMgmtObject [SWS_EthIf_91106] 📄 PDF
Std_ReturnType EthIf_GetTxMgmtObject (uint8 CtrlIdx, Eth_BufIdxType BufIdx, EthSwt_MgmtObjectType* * MgmtObjectPtr);
Request the Mgmt Object of the (in this context) unique Buf Idx.
फ़ंक्शन EthIf_SwitchEnableTimeStamping [SWS_EthIf_91007] 📄 PDF
Std_ReturnType EthIf_SwitchEnableTimeStamping (uint8 CtrlIdx, Eth_BufIdxType BufIdx, EthSwt_MgmtInfoType* MgmtInfo);
Activates egress time stamping on a dedicated message object, addressed by Ctrl Idx and Buf Idx.
फ़ंक्शन EthIf_SwitchEnableTimeStamping ([SWS_EthIf_91007]) स्विच स्तर पर एक विशिष्ट संदेश ऑब्जेक्ट के लिए एग्रेस टाइमस्टैम्प के अधिग्रहण को सक्रिय करता है। संबद्ध ट्रांसमिशन ऑब्जेक्ट को कंट्रोलर इंडेक्स CtrlIdx और बफ़र इंडेक्स BufIdx के माध्यम से एड्रेस किया जाता है।
कॉल और पैरामीटर
कॉल सिंक्रोनस रूप से होता है ([SWS_EthIf_91007])। इनपुट पैरामीटर के रूप में, फ़ंक्शन EthIf संदर्भ के भीतर कंट्रोलर इंडेक्स CtrlIdx की और संदेश बफ़र के लिए BufIdx की अपेक्षा करता है जहाँ एप्लिकेशन टाइमस्टैम्पिंग की अपेक्षा करता है। EthSwt_MgmtInfoType* प्रकार के आउटपुट पैरामीटर MgmtInfo के माध्यम से संबद्ध प्रबंधन जानकारी प्रदान की जाती है ([SWS_EthIf_91007])।
रिटर्न मान और व्यवहार
फ़ंक्शन प्रकार Std_ReturnType ([SWS_EthIf_91007]) के रिटर्न मान के माध्यम से परिणाम का संकेत देता है:
E_OK: एग्रेस टाइम-स्टैम्पिंग सफलतापूर्वक सक्रिय हो गई ([SWS_EthIf_91007])।E_NOT_OK: टाइमस्टैम्पिंग का सक्रियण विफल रहा ([SWS_EthIf_91007])।
सीमाएँ और समवर्तीता (concurrency)
इंटरफ़ेस को नॉन-रीएंट्रेंट (Non Reentrant) के रूप में निर्दिष्ट किया गया है ([SWS_EthIf_91007])। इसलिए कॉल करने वालों को यह सुनिश्चित करना चाहिए कि समानांतर कॉल रोके जाएँ। घोषणा हेडर EthIf.h के माध्यम से प्रदान की जाती है ([SWS_EthIf_91007])।
यह उपयोग नोट AUTOSAR R20-11 के आधार पर स्वचालित रूप से उत्पन्न किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_VerifyConfig [SWS_EthIf_91012] 📄 PDF
Std_ReturnType EthIf_VerifyConfig (uint8 SwitchIdx, boolean* Result);
Forwarded t o Eth Swt_ Verify Config. Eth Swt_ Verify Config verifies the Switch thernet Interface AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_EthernetInterface Configuration depending on the HW - Architecture, HW - capability and the intended accuracy of this verification.
तुल्यकालिक इंटरफ़ेस फ़ंक्शन EthIf_VerifyConfig स्विच कॉन्फ़िगरेशन के सत्यापन का काम करता है और कॉल को सीधे EthSwt_VerifyConfig पर अग्रेषित करता है [SWS_EthIf_91012]। वास्तविक सत्यापन ईथरनेट स्विच ड्राइवर द्वारा संबंधित हार्डवेयर आर्किटेक्चर, हार्डवेयर क्षमताओं और अभीष्ट परीक्षण सटीकता के आधार पर किया जाता है [SWS_EthIf_91012]।
उपयोग और पैरामीटर
यह फ़ंक्शन सर्विस-ID 0x40 के साथ हेडर EthIf.h के माध्यम से उपलब्ध है और दो पैरामीटरों की अपेक्षा करता है [SWS_EthIf_91012]:
SwitchIdx(in): Ethernet स्विच ड्राइवर के संदर्भ में स्विच का इंडेक्स।Result(out): एक बूलियन मान के लिए पॉइंटर जो सत्यापन परिणाम प्राप्त करता है।TRUEसफलतापूर्वक जाँचे गए कॉन्फ़िगरेशन को इंगित करता है, जबकिFALSEपहचानी गई क्षति की ओर संकेत करता है।
रिटर्न मान के रूप में, Std_ReturnType निष्पादन की स्थिति की रिपोर्ट करता है: E_OK संकेत देता है कि सत्यापन सफलतापूर्वक पूरा हो गया था, जबकि E_NOT_OK कॉन्फ़िगरेशन परीक्षण की विफलता को इंगित करता है [SWS_EthIf_91012]।
समवर्तीता और त्रुटि प्रबंधन
फ़ंक्शन को गैर-पुनःप्रवेशी (Non Reentrant) के रूप में निर्दिष्ट किया गया है [SWS_EthIf_91012]। इसलिए कॉल करने वालों को यह सुनिश्चित करना होगा कि कोई प्रतिस्पर्धी कॉल न हों। चूँकि पेलोड DET या DEM के लिए विशिष्ट त्रुटि कोड सूचीबद्ध नहीं करता है, इसलिए विस्तृत पैरामीटर जाँच (जैसे सूचकांकों या पॉइंटर्स का सत्यापन) संभवतः ड्राइवर पक्ष पर या कार्यान्वयन-विशिष्ट रूप से संभाली जाएगी। प्रश्न Q-03b5f343e97bec7f (खुला)
यह उपयोग संबंधी निर्देश स्वचालित रूप से उत्पन्न किया गया था और पूरी तरह से AUTOSAR R20-11 के विनिर्देश डेटा पर आधारित है।
फ़ंक्शन EthIf_SetForwardingMode [SWS_EthIf_91013] 📄 PDF
Std_ReturnType EthIf_SetForwardingMode (uint8 SwitchIdx, boolean mode);
Verifies the Switch Configuration. If Configuration is not valid, Switch is reconfigured.
तुल्यकालिक फ़ंक्शन EthIf_SetForwardingMode हेडर EthIf.h के माध्यम से प्रदान किया जाता है और ईथरनेट स्विच पर फ़्रेम फ़ॉरवर्डिंग को नियंत्रित करने का काम करता है [SWS_EthIf_91013]। यह वर्तमान स्विच कॉन्फ़िगरेशन की पुष्टि करता है और अमान्यता का पता चलने पर स्विच का पुनर्गठन (reconfiguration) करता है [SWS_EthIf_91013]।
पैरामीटर और रिटर्न मान
कॉल करने पर (सर्विस-ID 0x41), निम्नलिखित इनपुट पैरामीटर पास किए जाते हैं [SWS_EthIf_91013]:
SwitchIdx: ईथरनेट स्विच ड्राइवर के संदर्भ में संबंधित स्विच का इंडेक्स [SWS_EthIf_91013]।mode: फ़्रेम फ़ॉरवर्डिंग को सक्रिय (TRUE) या निष्क्रिय (FALSE) करने के लिए बूलियन स्विच [SWS_EthIf_91013]।
फ़ंक्शन Std_ReturnType रिटर्न मान के रूप में निम्नलिखित प्रदान करता है [SWS_EthIf_91013]:
E_OK: विनिर्देश के अनुसार फ़ॉरवर्डिंग को सफलतापूर्वक रोकने का संकेत दिया; व्याख्या: यह अधिक सामान्यतः अनुरोधित फ़ॉरवर्डिंग मोड को सफलतापूर्वक अपनाए जाने की पुष्टि करता प्रतीत होता है [SWS_EthIf_91013]। प्रश्न Q-f245de852fe854c0 (खुला)E_NOT_OK: फ़्रेम फ़ॉरवर्डिंग का स्विचिंग अथवा रोकना विफल हो गया है [SWS_EthIf_91013]।
समवर्तीता और प्रतिबंध
फ़ंक्शन को गैर-पुनःप्रवेशी (Non Reentrant) के रूप में निर्दिष्ट किया गया है [SWS_EthIf_91013]। इसलिए कॉल करने वालों को यह सुनिश्चित करना होगा कि समान या समानांतर स्विच संदर्भों के लिए कॉल क्रमित (serialized) रूप से किए जाएँ और कोई प्रतिस्पर्धी कॉल न हों। DET या DEM के लिए विशिष्ट त्रुटि कोड मानक में इस सेवा के लिए परिभाषित नहीं हैं।
यह उपयोग संबंधी निर्देश स्वचालित रूप से जनरेट किया गया था और यह AUTOSAR विनिर्देश पर आधारित है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_GetTrcvSignalQuality [SWS_EthIf_91056] 📄 PDF
Std_ReturnType EthIf_GetTrcvSignalQuality (uint8 TrcvIdx, EthIf_SignalQualityResultType* ResultPtr);
Retrieves the signal quality of the link of the given Ethernet transceiver
फ़ंक्शन EthIf_GetSwitchPortSignalQuality [SWS_EthIf_91058] 📄 PDF
Std_ReturnType EthIf_GetSwitchPortSignalQuality (uint8 SwitchIdx, uint8 SwitchPortIdx, EthIf_SignalQualityResultType* ResultPtr);
Retrieves the signal quality of the link of the given Ethernet switch port
फ़ंक्शन EthIf_ClearTrcvSignalQuality [SWS_EthIf_91059] 📄 PDF
Std_ReturnType EthIf_ClearTrcvSignalQuality (uint8 TrcvIdx);
Clear the stored signal quality of the link of the given Ethernet transceiver
फ़ंक्शन EthIf_ClearTrcvSignalQuality किसी विशिष्ट ट्रांसीवर [SWS_EthIf_91059] के लिए Ethernet कनेक्शन के संग्रहीत सिग्नल गुणवत्ता मानों को सिंक्रोनस रूप से हटाने का कार्य करता है। इसके लिए, कॉलर पैरामीटर TrcvIdx के साथ Ethernet Interface के संदर्भ में ट्रांसीवर का इंडेक्स पास करता है, जिसके बाद संबंधित मापे गए मान हटा दिए जाते हैं [SWS_EthIf_00400]।
रिटर्न वैल्यू के रूप में इंटरफ़ेस Std_ReturnType प्रकार प्रदान करता है: यदि सिग्नल गुणवत्ता का रीसेट सफल रहा, तो E_OK रिपोर्ट किया जाता है, अन्यथा प्रक्रिया E_NOT_OK के साथ विफल हो जाती है [SWS_EthIf_91059]। व्याख्या: एरर वैल्यू E_NOT_OK संभवतः अमान्य इंडेक्स पैरामीटर्स या अंतर्निहित ड्राइवर्स को अग्रेषण में त्रुटियों के कारण हो सकता है, क्योंकि पेलोड में किसी विशिष्ट एरर कोड या DET प्रविष्टियों का उल्लेख नहीं है। प्रश्न Q-40d8f0c1fc7ba11e (खुला)
समवर्तीता के संबंध में, सेवा को अलग-अलग ट्रांसीवर इंडेक्स के लिए रीएंट्रेंट कार्यान्वित किया गया है, लेकिन समान TrcvIdx [SWS_EthIf_91059] के लिए स्पष्ट रूप से नॉन-रीएंट्रेंट है। इसलिए समान ट्रांसीवर के लिए कई कॉल्स समवर्ती संदर्भों से एक साथ नहीं होने चाहिए और उन्हें तदनुसार सुरक्षित किया जाना चाहिए।
मॉड्यूल परस्पर क्रिया में, यह कॉल TrcvIdx के माध्यम से एड्रेस किए गए EthIfTransceiver [SWS_EthIf_00400] के लिए EthIf_SignalQualityResultType प्रकार के संग्रहीत सिग्नल गुणवत्ता मानों को लक्षित रूप से हटाता है। सर्विस-ID 0x19 के साथ सिंक्रोनस इंटरफ़ेस का डिक्लेरेशन हेडर EthIf.h के माध्यम से उपलब्ध कराया जाता है [SWS_EthIf_91059]।
यह पाठ AUTOSAR विनिर्देश R20-11 के आधार पर AI द्वारा उत्पन्न किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_ClearSwitchPortSignalQuality [SWS_EthIf_91060] 📄 PDF
Std_ReturnType EthIf_ClearSwitchPortSignalQuality (uint8 SwitchIdx, uint8 SwitchPortIdx);
Clear the stored signal quality of the link of the given Et hernet switch port
उपयोग
सिंक्रोनस फ़ंक्शन EthIf_ClearSwitchPortSignalQuality किसी विशिष्ट Ethernet स्विच पोर्ट [SWS_EthIf_91060] के कनेक्शन के लिए संग्रहीत सिग्नल गुणवत्ता मानों को रीसेट करने का कार्य करता है। लक्ष्य पोर्ट का एड्रेसिंग दो इनपुट पैरामीटर्स SwitchIdx (Ethernet स्विच का इंडेक्स) और SwitchPortIdx (इंटरफ़ेस संदर्भ के भीतर पोर्ट का इंडेक्स) [SWS_EthIf_91060] के माध्यम से किया जाता है। फ़ंक्शन हेडर फ़ाइल EthIf.h के माध्यम से उपलब्ध है [SWS_EthIf_91060]।
परस्पर क्रिया और डेटा संरचनाएँ
[SWS_EthIf_00404] के अनुसार, यह कॉल एड्रेस किए गए स्विच पोर्ट के आंतरिक रूप से रखे गए सिग्नल गुणवत्ता मानों को हटा देता है, जो EthIf_SignalQualityResultType प्रकार के अनुरूप होते हैं। यह उच्च-स्तरीय मॉड्यूलों को ऐतिहासिक मापे गए मानों को लक्षित रूप से त्यागने और कनेक्शन गुणवत्ता का पुनर्मूल्यांकन शुरू करने में सक्षम बनाता है।
त्रुटि प्रबंधन
ऑपरेशन की सफलता Std_ReturnType प्रकार के रिटर्न मान के माध्यम से प्रदर्शित होती है: सफल विलोपन पर, फ़ंक्शन E_OK देता है, अन्यथा E_NOT_OK [SWS_EthIf_91060]। पेलोड में विशिष्ट DET या DEM एरर कोड परिभाषित नहीं हैं। व्याख्या: रिटर्न वैल्यू E_NOT_OK विशेष रूप से तब उत्पन्न हो सकता है जब अमान्य इंडेक्स पास किए जाते हैं या अंतर्निहित स्विच ड्राइवर रीसेट निष्पादित करने में असमर्थ होता है। प्रश्न Q-fc42f5b3e5414f6a (खुला)
समवर्तीता और प्रतिबंध
रीएंट्रेंसी के संबंध में, EthIf_ClearSwitchPortSignalQuality विभिन्न स्विच और स्विच पोर्ट इंडेक्स [SWS_EthIf_91060] के लिए रीएंट्रेंट है। हालांकि, समान स्विच पोर्ट (SwitchPortIdx) के लिए फ़ंक्शन को नॉन-रीएंट्रेंट निर्दिष्ट किया गया है [SWS_EthIf_91060]। इसलिए कॉलर्स को यह सुनिश्चित करना चाहिए कि समान पोर्ट के लिए एक साथ कॉल्स से बचा जाए या उपयुक्त सिंक्रोनाइज़ेशन तंत्रों द्वारा सुरक्षित किया जाए।
यह पाठ एक AI द्वारा तैयार किया गया था और यह ओरिएंटेशन दस्तावेज़ीकरण के रूप में कार्य करता है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SetPhyTestMode [SWS_EthIf_91016] 📄 PDF
Std_ReturnType EthIf_SetPhyTestMode (uint8 TrcvIdx, EthTrcv_PhyTestModeType Mode);
Activates a given test mode.
सिंक्रोनस इंटरफ़ेस फ़ंक्शन EthIf_SetPhyTestMode का उपयोग Ethernet ट्रांसीवर [SWS_EthIf_91016] पर पूर्वनिर्धारित परीक्षण मोड को सक्रिय करने के लिए किया जाता है। यह सेवा हेडर फ़ाइल EthIf.h में घोषित है और हेक्साडेसिमल सर्विस-ID 0x17 के माध्यम से पहचानी जा सकती है [SWS_EthIf_91016]।
फ़ंक्शन कॉल किए जाने के लिए दो इनपुट पैरामीटर [SWS_EthIf_91016] पास किए जाने की अपेक्षा करता है:
TrcvIdx: Ethernet Interface [SWS_EthIf_91016] के संदर्भ में लक्ष्य ट्रांसीवर के संख्यात्मक इंडेक्स को निर्धारित करता है।Mode:EthTrcv_PhyTestModeTypeप्रकार के सक्रिय किए जाने वाले विशिष्ट परीक्षण मोड को परिभाषित करता है [SWS_EthIf_91016]।
कोई इनपुट और आउटपुट पैरामीटर मौजूद नहीं हैं [SWS_EthIf_91016]। रिटर्न वैल्यू के रूप में, यह सेवा Std_ReturnType प्रकार का स्टेटस प्रदान करती है [SWS_EthIf_91016]। रिटर्न वैल्यू E_OK इस बात की पुष्टि करती है कि परीक्षण मोड सक्रियण का अनुरोध सफलतापूर्वक स्वीकार कर लिया गया था [SWS_EthIf_91016]। इसके विपरीत, मान E_NOT_OK यह इंगित करता है कि अनुरोध अस्वीकार कर दिया गया था और परीक्षण मोड सक्रिय नहीं किया जा सका [SWS_EthIf_91016]।
समवर्तीता (concurrency) के संबंध में, EthIf_SetPhyTestMode को अलग-अलग ट्रांसीवर इंडेक्स (TrcvIdx) के लिए रीएंट्रेंट (reentrant) निर्दिष्ट किया गया है [SWS_EthIf_91016]। समान ट्रांसीवर इंडेक्स के लिए निष्पादन स्पष्ट रूप से नॉन-रीएंट्रेंट (not reentrant) है [SWS_EthIf_91016]। इसलिए कॉलर्स को यह सुनिश्चित करना चाहिए कि समान ट्रांसीवर इंस्टेंस के लिए समवर्ती कॉल्स से बचा जाए और इसके बजाय उन्हें क्रमिक रूप से समन्वित किया जाए।
यह पाठ विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SetPhyLoopbackMode [SWS_EthIf_91018] 📄 PDF
Std_ReturnType EthIf_SetPhyLoopbackMode (uint8 TrcvIdx, EthTrcv_PhyLoopbackModeType Mode);
Activates a given loopback mode.
उपयोग
सिंक्रोनस फ़ंक्शन EthIf_SetPhyLoopbackMode Ethernet ट्रांसीवर [SWS_EthIf_91018] पर निर्दिष्ट लूपबैक मोड को सक्रिय करने का कार्य करता है। इसका डिक्लेरेशन हेडर फ़ाइल EthIf.h के माध्यम से उपलब्ध है [SWS_EthIf_91018]।
कॉल किए जाने पर, फ़ंक्शन दो इनपुट पैरामीटर्स की अपेक्षा करता है:
TrcvIdx: Ethernet Interface [SWS_EthIf_91018] के संदर्भ में ट्रांसीवर का इंडेक्स।Mode:EthTrcv_PhyLoopbackModeTypeप्रकार का सक्रिय किया जाने वाला लूपबैक मोड [SWS_EthIf_91018]।
रिटर्न वैल्यू के रूप में, फ़ंक्शन Std_ReturnType प्रकार का स्टेटस प्रदान करता है: E_OK यह संकेत देता है कि अनुरोध स्वीकार कर लिया गया था, जबकि E_NOT_OK यह इंगित करता है कि अनुरोध स्वीकार नहीं किया जा सका [SWS_EthIf_91018]। व्याख्या: फ़ंक्शन संभवतः कॉल को TrcvIdx के लिए उत्तरदायी Ethernet ट्रांसीवर ड्राइवर को सिंक्रोनस रूप से अग्रेषित करता है। प्रश्न Q-c4736bbfd250cca0 (खुला)
त्रुटि प्रबंधन
विशिष्ट एरर कोड जैसे DET संदेश या DEM इवेंट्स विनिर्देश के उद्धरण में परिभाषित नहीं हैं। यदि अनुरोध की स्वीकृति विफल हो जाती है, तो कॉलर को सीधे रिटर्न वैल्यू E_NOT_OK के माध्यम से सूचित किया जाता है [SWS_EthIf_91018]। आगामी परीक्षण या निदान प्रक्रियाओं को जारी रखने से पहले कॉलर्स को इस रिटर्न वैल्यू की जांच करनी चाहिए।
समवर्तीता और प्रतिबंध
फ़ंक्शन अलग-अलग ट्रांसीवर इंडेक्स (TrcvIdx) के लिए रीएंट्रेंट है, लेकिन समान ट्रांसीवर इंडेक्स [SWS_EthIf_91018] के लिए स्पष्ट रूप से नॉन-रीएंट्रेंट है। इसलिए कॉलर्स को यह सुनिश्चित करना चाहिए कि समान ट्रांसीवर इंस्टेंस के लिए समकालिक कॉल्स से बचा जाए या उपयुक्त सिंक्रोनाइज़ेशन तंत्रों द्वारा सुरक्षित किया जाए [SWS_EthIf_91018]।
यह टेक्स्ट एक AI द्वारा तैयार किया गया था और AUTOSAR विनिर्देश पर आधारित है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SetPhyTxMode [SWS_EthIf_91005] 📄 PDF
Std_ReturnType EthIf_SetPhyTxMode (uint8 TrcvIdx, EthTrcv_PhyTxModeType Mode);
Activates a given transmission mode. Tags: atp.Status=draft
सिंक्रोनस इंटरफ़ेस फ़ंक्शन EthIf_SetPhyTxMode किसी Ethernet ट्रांसीवर के लिए निर्दिष्ट ट्रांसमिशन मोड को सक्रिय करने का कार्य करता है [SWS_EthIf_91005]। फ़ंक्शन की घोषणा हेडर फ़ाइल EthIf.h में सर्विस ID 0x13 के अंतर्गत की गई है [SWS_EthIf_91005]।
कॉल के लिए फ़ंक्शन दो इनपुट पैरामीटर की अपेक्षा करता है [SWS_EthIf_91005]:
TrcvIdx: Ethernet इंटरफ़ेस के संदर्भ में संबंधित ट्रांसीवर का संख्यात्मक इंडेक्स।Mode:EthTrcv_PhyTxModeTypeप्रकार का विशिष्ट रूप से सक्रिय किया जाने वाला ट्रांसमिट मोड।
निष्पादन सिंक्रोनस रूप से होता है। रिटर्न मान के रूप में, फ़ंक्शन Std_ReturnType प्रकार का स्टेटस लौटाता है [SWS_EthIf_91005]। मान E_OK अनुरोध की सफल स्वीकृति की पुष्टि करता है, जबकि E_NOT_OK संकेत देता है कि अनुरोध स्वीकार नहीं किया जा सका [SWS_EthIf_91005]। विनिर्देश डेटा में विशिष्ट त्रुटि कोड या डेवलपमेंट एरर मैनेजमेंट (DET) या डायग्नोस्टिक इवेंट मैनेजमेंट (DEM) को सूचनाएँ नहीं दर्शाई गई हैं।
समवर्ती व्यवहार के संबंध में, EthIf_SetPhyTxMode भिन्न ट्रांसीवर इंडेक्सों (TrcvIdx) के लिए रीएंट्रेंट है [SWS_EthIf_91005]। हालाँकि, यदि समान ट्रांसीवर इंडेक्स के लिए कॉल जारी किए जाते हैं, तो फ़ंक्शन को नॉन-रीएंट्रेंट के रूप में परिभाषित किया गया है और इसके लिए सिंक्रोनाइज़्ड या क्रमिक कॉल की आवश्यकता होती है [SWS_EthIf_91005]।
एक औपचारिक प्रतिबंध के रूप में यह ध्यान दिया जाना चाहिए कि AUTOSAR CP R20-11 विनिर्देश में इस इंटरफ़ेस तत्व को स्थिति draft के साथ चिह्नित किया गया है [SWS_EthIf_91005]।
यह उपयोग नोट AUTOSAR CP R20-11 विनिर्देश के आधार पर एक AI द्वारा तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_GetCableDiagnosticsResult [SWS_EthIf_91014] 📄 PDF
Std_ReturnType EthIf_GetCableDiagnosticsResult (uint8 TrcvIdx, EthTrcv_CableDiagResultType* ResultPtr);
Retrieves the cable diagnostics result of a given transceiver.
फ़ंक्शन EthIf_GetPhyIdentifier [SWS_EthIf_91020] 📄 PDF
Std_ReturnType EthIf_GetPhyIdentifier (uint8 TrcvIdx, uint32* OrgUniqueIdPtr, uint8* ModelNrPtr, uint8* RevisionNrPtr);
Obtains the PHY identifier of the Ethernet Interface according to IEEE 802.3 - chapter 22.2.4.3.1 PHY Identifer.
फ़ंक्शन EthIf_GetBufWRxParams [SWS_EthIf_91002] 📄 PDF
Std_ReturnType EthIf_GetBufWRxParams (uint8 CtrlIdx, const WEth_BufWRxParamIdType* RxParamIds, uint32* ParamValues, uint8 NumParams);
Read out values related to the receive direction of the transceiver for a received packet. For example, this could be RSSI or Channel belonging to one single packet.
फ़ंक्शन EthIf_GetBufWTxParams [SWS_EthIf_91054] 📄 PDF
Std_ReturnType EthIf_GetBufWTxParams (uint8 CtrlIdx, const WEth_BufWTxParamIdType* TxParamIds, uint32* ParamValues, uint8 NumParams);
Read out values related to the transmit direction of the transceiver for a transmitted packet. For example, this could be transaction ID belonging to one single packet.
फ़ंक्शन EthIf_SetBufWTxParams [SWS_EthIf_91017] 📄 PDF
Std_ReturnType EthIf_SetBufWTxParams (uint8 CtrlIdx, Eth_BufIdxType BufIdx, const WEth_BufWTxParamIdType* TxParamIds, const uint32* ParamValues, uint8 NumParams);
Set values related to the transmit direction of the transceiver for a specific buffer (packet to be sent). For example, this can be the desired transmit power or the channel belonging to one single packet.
फ़ंक्शन EthIf_SetRadioParams [SWS_EthIf_91026] 📄 PDF
Std_ReturnType EthIf_SetRadioParams (uint8 TrcvId, const WEthTrcv_SetRadioParamIdType* ParamIds, const uint32* ParamValue, uint8 NumParams);
Set values related to a transceiver's wireless radio. For example, this could be the selection of the radio settings (channel, ...).
फ़ंक्शन EthIf_SetChanRxParams [SWS_EthIf_91034] 📄 PDF
Std_ReturnType EthIf_SetChanRxParams (uint8 TrcvId, uint8 RadioId, const WEthTrcv_SetChanRxParamIdType* ParamIds, const uint32* ParamValues, uint8 NumParams);
Set values related to the receive direction of a transceiver's wireless channel. For example, this could be a channel parameter like the frequency.
फ़ंक्शन EthIf_SetChanTxParams [SWS_EthIf_91042] 📄 PDF
Std_ReturnType EthIf_SetChanTxParams (uint8 TrcvId, uint8 RadioId, const WEthTrcv_SetChanTxParamIdType* TxParamIds, const uint32* ParamValues, uint8 NumParams);
Set values related to the transmit direction of a transceiver's wireless channel. For example, this could be the bitrate of a channel.
फ़ंक्शन EthIf_GetChanRxParams [SWS_EthIf_91050] 📄 PDF
Std_ReturnType EthIf_GetChanRxParams (uint8 TrcvId, uint8 RadioId, const WEthTrcv_GetChanRxParamIdType* ParamIds, thernetInterface uint32* ParamValues, uint8 NumParams); ⚠️
Read values related to the receive direction of the transceiver. For example, this could be a Channel Busy Ratio (CBR) or the average Channel Idle Time (CIT).
फ़ंक्शन EthIf_ProvideTxBuffer [SWS_EthIf_00067] 📄 PDF
BufReq_ReturnType EthIf_ProvideTxBuffer (uint8 CtrlIdx, Eth_FrameType FrameType, uint8 Priority, Eth_BufIdxType* BufIdxPtr, uint8* * BufPtr, uint16* LenBytePtr);
Provides access to a transmit buffer of the specified Ethernet controller.
सिंक्रोनस और रीएंट्रेंट फ़ंक्शन EthIf_ProvideTxBuffer (सर्विस-ID 0x09) CtrlIdx के माध्यम से निर्दिष्ट ईथरनेट नियंत्रक के एक ट्रांसमिट बफर तक पहुंच प्रदान करता है और हेडर EthIf.h के माध्यम से उपलब्ध है [SWS_EthIf_00067]।
बफर का अनुरोध करने के लिए, कॉलर कंट्रोलर इंडेक्स (CtrlIdx), ईथरनेट फ्रेम प्रकार (FrameType) के साथ-साथ VLAN टैग के 3-बिट PCP फ़ील्ड के लिए प्राथमिकता (Priority) पास करता है [SWS_EthIf_00067]। इनपुट और आउटपुट पैरामीटर LenBytePtr के माध्यम से, कॉलर बाइट्स में वांछित बफर आकार निर्दिष्ट करता है और वास्तव में प्रदान की गई लंबाई प्राप्त करता है [SWS_EthIf_00067]। सफल आवंटन पर, फ़ंक्शन BufPtr के माध्यम से बफर के लिए एक पॉइंटर और BufIdxPtr के माध्यम से बाद के अनुरोधों के लिए बफर संसाधन का इंडेक्स प्रदान करता है [SWS_EthIf_00067]।
बफर अनुरोध का परिणाम रिटर्न प्रकार BufReq_ReturnType के माध्यम से रिपोर्ट किया जाता है [SWS_EthIf_00067]:
BUFREQ_OK: बफर सफलतापूर्वक प्रदान किया गया [SWS_EthIf_00067]।BUFREQ_E_BUSY: सभी बफ़र संसाधन वर्तमान में व्यस्त हैं [SWS_EthIf_00067]।BUFREQ_E_OVFL: अनुरोधित बफर लंबाई उपलब्ध आकार से अधिक है [SWS_EthIf_00067]।BUFREQ_E_NOT_OK: एक डेवलपमेंट त्रुटि का पता चला [SWS_EthIf_00067]।
यह उपयोग संबंधी निर्देश AUTOSAR CP R20-11 विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।
फ़ंक्शन EthIf_Transmit [SWS_EthIf_00075] 📄 PDF
Std_ReturnType EthIf_Transmit (uint8 CtrlIdx, Eth_BufIdxType BufIdx, Eth_FrameType FrameType, boolean TxConfirmation, uint16 LenByte, const uint8* PhysAddrPtr);
Triggers transmission of a previously filled transmit buffer
सिंक्रोनस फ़ंक्शन EthIf_Transmit ईथरनेट इंटरफ़ेस के माध्यम से पहले से प्रदान किए गए और भरे गए ट्रांसमिशन बफ़र के प्रसारण को ट्रिगर करता है [SWS_EthIf_00075]।
उपयोग और पैरामीटर
कॉल EthIf.h में घोषित इंटरफ़ेस के माध्यम से निम्नलिखित पासिंग पैरामीटरों के साथ किया जाता है [SWS_EthIf_00075]:
CtrlIdx: मॉड्यूलEthIfके संदर्भ में ईथरनेट कंट्रोलर का इंडेक्स।BufIdx: प्रसारित किए जाने वाले बफ़र संसाधन का इंडेक्स।FrameType: Ethernet-फ़्रेम प्रकार।TxConfirmation: ट्रांसमिशन पुष्टिकरण के सक्रियण को नियंत्रित करता है।LenByte: बाइट्स में डेटा की लंबाई।PhysAddrPtr: नेटवर्क बाइट क्रम में भौतिक गंतव्य पता (MAC पता)।
रिटर्न मान और समवर्तीता
रिटर्न मान के रूप में, फ़ंक्शन ट्रांसमिशन के सफल ट्रिगर होने पर E_OK या ट्रांसमिशन विफल होने पर E_NOT_OK प्रदान करता है [SWS_EthIf_00075]। विभिन्न बफ़र और कंट्रोलर इंडेक्स (BufIdx और CtrlIdx) वाले कॉल के लिए फ़ंक्शन रीएंट्रेंट है [SWS_EthIf_00075]।
यह उपयोग नोट AUTOSAR विनिर्देश R20-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_GetVersionInfo [SWS_EthIf_00082] 📄 PDF
void EthIf_GetVersionInfo (Std_VersionInfoType* VersionInfoPtr);
Returns the version information of this module
फ़ंक्शन EthIf_GetSwitchPortMode [SWS_EthIf_91107] 📄 PDF
Std_ReturnType EthIf_GetSwitchPortMode (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_ModeType* PortModePtr);
Obtains the mode of the indexed switch port
फ़ंक्शन EthIf_GetTransceiverMode [SWS_EthIf_91108] 📄 PDF
Std_ReturnType EthIf_GetTransceiverMode (uint8 TrcvIdx, Eth_ModeType* TrcvModePtr);
Obtains the state of the indexed transceiver
फ़ंक्शन EthIf_SwitchPortGetLinkState [SWS_EthIf_91109] 📄 PDF
Std_ReturnType EthIf_SwitchPortGetLinkState (uint8 SwitchIdx, uint8 SwitchPortIdx, EthTrcv_LinkStateType* LinkStatePtr);
Obtains the link state of the indexed switch port
फ़ंक्शन EthIf_SwitchPortGetLinkState [SWS_EthIf_91109] के अनुसार किसी विशिष्ट स्विच पोर्ट की वर्तमान कनेक्शन स्थिति को क्वेरी करने का कार्य करता है। Ethernet स्विच ड्राइवर के संदर्भ में स्विच इंडेक्स SwitchIdx और एड्रेस किए गए स्विच पर पोर्ट इंडेक्स SwitchPortIdx पास किए जाते हैं। क्वेरी परिणाम पॉइंटर LinkStatePtr के माध्यम से प्रदान किया जाता है, जो या तो ETHTRCV_LINK_STATE_DOWN (पोर्ट डिस्कनेक्टेड) या ETHTRCV_LINK_STATE_ACTIVE (पोर्ट कनेक्टेड) ग्रहण करता है। विनिर्देश निष्पादन व्यवहार को सिंक्रोनस या एसिंक्रोनस के रूप में इंगित करता है; यह संभवतः अंतर्निहित स्विच ड्राइवर या हार्डवेयर कनेक्शन पर निर्भर करता है। प्रश्न Q-dde6f9e8f1b8ba52 (खुला)
रिटर्न वैल्यू के रूप में, फ़ंक्शन Std_ReturnType ([SWS_EthIf_91109]) प्रदान करता है। सफल क्वेरी पर, E_OK वापस किया जाता है। यदि कनेक्शन स्थिति का निर्धारण विफल हो जाता है या फ़ंक्शन को तब कॉल किया जाता है जब स्विच ETHSWT_STATE_UNINIT या ETHSWT_STATE_INIT स्थिति में होता है, तो E_NOT_OK वापस किया जाता है।
समवर्तीता के संबंध में, फ़ंक्शन को नॉन-रीएंट्रेंट (Non Reentrant) निर्दिष्ट किया गया है ([SWS_EthIf_91109]), जिसके कारण समान संदर्भ में एक साथ कॉल्स को बाहर रखा जाना चाहिए। डिक्लेरेशन सर्विस-ID 0x4b के साथ हेडर EthIf.h के माध्यम से उपलब्ध है।
यह पाठ AI द्वारा तैयार किया गया था; संदर्भित AUTOSAR विनिर्देश ही प्रामाणिक है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_TransceiverGetLinkState [SWS_EthIf_91110] 📄 PDF
Std_ReturnType EthIf_TransceiverGetLinkState (uint8 TrcvIdx, EthTrcv_LinkStateType* LinkStatePtr);
Obta ins the link state of the indexed transceiver
उपयोग
सिंक्रोनस फ़ंक्शन EthIf_TransceiverGetLinkState [SWS_EthIf_91110] के अनुसार TrcvIdx के माध्यम से एड्रेस किए गए Ethernet ट्रांसीवर की वर्तमान कनेक्शन स्थिति (Link State) को क्वेरी करने का कार्य करता है। इंटरफ़ेस का डिक्लेरेशन हेडर EthIf.h के माध्यम से उपलब्ध कराया जाता है [SWS_EthIf_91110]।
कॉल करते समय निम्नलिखित पैरामीटर पास किए जाते हैं [SWS_EthIf_91110]:
TrcvIdx(इनपुट): Ethernet Transceiver Driver के संदर्भ में ट्रांसीवर का इंडेक्स।LinkStatePtr(आउटपुट):EthTrcv_LinkStateTypeप्रकार की निर्धारित स्थिति के लिए मेमोरी स्थान का पॉइंटर। संभावित परिणाम मान कनेक्टेड ट्रांसीवर के लिएETHTRCV_LINK_STATE_ACTIVEऔर डिस्कनेक्टेड ट्रांसीवर के लिएETHTRCV_LINK_STATE_DOWNहैं।
रिटर्न वैल्यू के रूप में, फ़ंक्शन Std_ReturnType प्रकार का स्टेटस कोड प्रदान करता है: E_OK सफल निष्पादन का संकेत देता है, जबकि E_NOT_OK यह इंगित करता है कि ट्रांसीवर को इनिशियलाइज़ नहीं किया जा सका [SWS_EthIf_91110]।
त्रुटि प्रबंधन और सीमा शर्तें
यदि क्वेरी विफल हो जाती है, तो सर्विस-ID 0x4c वाली सेवा रिटर्न वैल्यू E_NOT_OK प्रदान करती है [SWS_EthIf_91110]। फ़ंक्शन विनिर्देश में विशिष्ट DET या DEM त्रुटि संदेश सूचीबद्ध नहीं हैं।
संगामिति
फ़ंक्शन को नॉन-रीएंट्रेंट (Non Reentrant) के रूप में निर्दिष्ट किया गया है [SWS_EthIf_91110]। व्याख्या: रीएंट्रेंसी की कमी के कारण, कई थ्रेड्स या टास्क संदर्भों से एक साथ कॉल अमान्य हो सकता है और आवश्यकता पड़ने पर कॉलर-साइड सिंक्रोनाइज़ेशन की आवश्यकता होती है। प्रश्न Q-0459aa9b4c187439 (खुला)
यह उपयोग संबंधी निर्देश विनिर्देश SWS_EthIf_91110 के आधार पर स्वचालित रूप से तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SwitchPortGetBaudRate [SWS_EthIf_91111] 📄 PDF
Std_ReturnType EthIf_SwitchPortGetBaudRate (thernetInterface uint8 SwitchIdx, uint8 SwitchPortIdx, EthTrcv_BaudRateType* BaudRatePtr); ⚠️
Obtains the baud rate of the indexed switch port
फ़ंक्शन EthIf_SwitchPortGetBaudRate [SWS_EthIf_91111] के अनुसार किसी विशिष्ट Ethernet स्विच पोर्ट की वर्तमान ट्रांसमिशन गति को क्वेरी करने का कार्य करता है। कॉल करते समय, स्विच का इंडेक्स (SwitchIdx) और एड्रेस किए गए स्विच पर पोर्ट का इंडेक्स (SwitchPortIdx) पास किए जाते हैं। क्वेरी परिणाम EthTrcv_BaudRateType* प्रकार के पॉइंटर BaudRatePtr के माध्यम से प्रदान किया जाता है, जो ETHTRCV_BAUD_RATE_10MBIT, ETHTRCV_BAUD_RATE_100MBIT, ETHTRCV_BAUD_RATE_1000MBIT या ETHTRCV_BAUD_RATE_2500MBIT जैसी गतियों को मैप कर सकता है [SWS_EthIf_91111]।
त्रुटि व्यवहार के संबंध में, बॉड दर के सफल निर्धारण पर फ़ंक्शन E_OK लौटाता है। E_NOT_OK का रिटर्न मान यह संकेत देता है कि निर्दिष्ट स्विच पोर्ट के लिए बॉड दर नहीं पढ़ी जा सकी या स्विच ड्राइवर ETHSWT_STATE_UNINIT अथवा ETHSWT_STATE_INIT स्थिति में है [SWS_EthIf_91111]।
विनिर्देश फ़ंक्शन को नॉन-रीएंट्रेंट (Non Reentrant) और सिंक्रोनस/एसिंक्रोनस के रूप में इंगित करता है [SWS_EthIf_91111]। संभवतः सिंक्रोनस या एसिंक्रोनस व्यवहार अंतर्निहित Ethernet स्विच ड्राइवर के कनेक्शन और कार्यान्वयन पर निर्भर करता है। प्रश्न Q-1f4d760ff944df9d (खुला) रीएंट्रेंसी के अभाव के कारण, कॉलर्स को यह सुनिश्चित करना चाहिए कि इंटरफ़ेस के समानांतर कॉल्स से बचा जाए।
यह उपयोग निर्देश स्वचालित रूप से जनरेट किया गया था और AUTOSAR विनिर्देश R20-11 पर आधारित है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_TransceiverGetBaudRate [SWS_EthIf_91112] 📄 PDF
Std_ReturnType EthIf_TransceiverGetBaudRate (uint8 TrcvIdx, EthTrcv_BaudRateType* BaudRatePtr);
Obtains the baud rate of the indexed transceiver
सर्विस-ID 0x4e वाला सिंक्रोनस फ़ंक्शन EthIf_TransceiverGetBaudRate किसी इंडेक्स किए गए Ethernet ट्रांसीवर [SWS_EthIf_91112] की वर्तमान ट्रांसमिशन दर को पढ़ने का कार्य करता है। यह मॉड्यूल EthIf का घटक है और हेडर फ़ाइल EthIf.h के माध्यम से उपलब्ध कराया जाता है [SWS_EthIf_91112]।
uint8 प्रकार का इनपुट पैरामीटर TrcvIdx Ethernet ट्रांसीवर ड्राइवर [SWS_EthIf_91112] के संदर्भ में ट्रांसीवर की पहचान करता है। कोई Inout पैरामीटर मौजूद नहीं हैं [SWS_EthIf_91112]। क्वेरी का परिणाम आउटपुट पैरामीटर BaudRatePtr के माध्यम से वापस किया जाता है [SWS_EthIf_91112]। Eth_Trcv_BaudRateType प्रकार के मान्य मान ETHTRCV_BAUD_RATE_10MBIT (10 MBit/s), ETHTRCV_BAUD_RATE_100MBIT (100 MBit/s), ETHTRCV_BAUD_RATE_1000MBIT (1000 MBit/s) साथ ही ETHTRCV_BAUD_RATE_2500MBIT (2500 MBit/s) हैं [SWS_EthIf_91112]।
फ़ंक्शन Std_ReturnType प्रकार का स्टेटस लौटाता है: सफल कॉल पर E_OK पास किया जाता है [SWS_EthIf_91112]। यदि ट्रांसीवर को इनिशियलाइज़ नहीं किया जा सका, तो सेवा विफल हो जाती है और E_NOT_OK रिपोर्ट करती है [SWS_EthIf_91112]।
कॉल संदर्भ और समवर्तीता (concurrency) के संबंध में, EthIf_TransceiverGetBaudRate को एक तुल्यकालिक (synchronous) और गैर-पुनःप्रवेशी (non-reentrant) (Non Reentrant) इंटरफ़ेस के रूप में परिभाषित किया गया है [SWS_EthIf_91112]। कॉल करने वाले स्तरों (calling layers) को यह सुनिश्चित करना होगा कि इस सेवा के लिए समवर्ती कॉल्स से बचा जाए या उन्हें कॉलर स्तर पर क्रमबद्ध (serialized) किया जाए [SWS_EthIf_91112]।
यह पाठ AUTOSAR CP R20-11 विनिर्देश के आधार पर एक AI द्वारा तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SwitchPortGetDuplexMode [SWS_EthIf_91113] 📄 PDF
Std_ReturnType EthIf_SwitchPortGetDuplexMode (uint8 SwitchIdx, uint8 SwitchPortIdx, EthTrcv_DuplexModeType* DuplexModePtr);
Obtains the duplex mode of the indexed switch port
फ़ंक्शन EthIf_SwitchPortGetDuplexMode एक Ethernet स्विच [SWS_EthIf_91113] पर अनुक्रमित पोर्ट के वर्तमान डुप्लेक्स मोड को क्वेरी करने का काम करता है। यह कॉल को SwitchIdx के माध्यम से निर्दिष्ट Ethernet स्विच ड्राइवर के फ़ंक्शन EthSwt_GetDuplexMode पर अग्रेषित करता है [SWS_EthIf_00428]।
पैरामीटर और इंटरफ़ेस
SwitchIdx: ड्राइवर [SWS_EthIf_91113] के संदर्भ में Ethernet स्विच का इंडेक्स।SwitchPortIdx: संबोधित स्विच [SWS_EthIf_91113] पर संबंधित पोर्ट का इंडेक्स।DuplexModePtr: निर्धारित मोड के लिएEthTrcv_DuplexModeType*प्रकार का आउटपुट पॉइंटर, या तोETHTRCV_DUPLEX_MODE_HALF(हाफ़ डुप्लेक्स) याETHTRCV_DUPLEXMODE_FULL(फ़ुल डुप्लेक्स) [SWS_EthIf_91113]।
निष्पादन और त्रुटि प्रबंधन
रिटर्न मान E_OK एक सफल क्वेरी का संकेत देता है [SWS_EthIf_91113]। यदि पोर्ट के डुप्लेक्स मोड को निर्धारित नहीं किया जा सकता है या ड्राइवर ETHSWT_STATE_UNINIT अथवा ETHSWT_STATE_INIT अवस्थाओं में है, तो फ़ंक्शन E_NOT_OK लौटाता है [SWS_EthIf_91113]।
इंटरफ़ेस गैर-पुनःप्रवेशी (Non Reentrant) है और विनिर्देश में इसे तुल्यकालिक/अतुल्यकालिक घोषित किया गया है [SWS_EthIf_91113]। व्याख्या: वास्तविक तुल्यकालिक या अतुल्यकालिक कार्यप्रणाली संबद्ध स्विच ड्राइवर की विशेषताओं पर निर्भर होने की संभावना है। प्रश्न Q-339413722431978f (खुला)
यह उपयोग नोट विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_TransceiverGetDuplexMode [SWS_EthIf_91114] 📄 PDF
Std_ReturnType EthIf_TransceiverGetDuplexMode (uint8 TrcvIdx, EthTrcv_DuplexModeType* DuplexModePtr);
Obtains the duplex mode of the indexed tra nsceiver
तुल्यकालिक फ़ंक्शन EthIf_TransceiverGetDuplexMode, [SWS_EthIf_91114] के अनुसार किसी अनुक्रमित Ethernet ट्रांसीवर के वर्तमान डुप्लेक्स मोड को निर्धारित करता है।
उपयोग और पैरामीटर
कॉल तुल्यकालिक रूप से निष्पादित होता है और इसे गैर-पुनःप्रवेशी (Non Reentrant) के रूप में निर्दिष्ट किया गया है [SWS_EthIf_91114]:
TrcvIdx: Ethernet ट्रांसीवर ड्राइवर [SWS_EthIf_91114] के संदर्भ में इनपुट पैरामीटर के रूप में ट्रांसीवर का इंडेक्स पास करता है।DuplexModePtr: परिणाम प्राप्त करने के लिएEthTrcv_DuplexModeTypeप्रकार के आउटपुट पॉइंटर के रूप में कार्य करता है। संभावित मानETHTRCV_DUPLEX_MODE_HALF(हाफ़ डुप्लेक्स) याETHTRCV_DUPLEX_MODE_FULL(फ़ुल डुप्लेक्स) हैं [SWS_EthIf_91114]।
रिटर्न मान और त्रुटि प्रबंधन
रिटर्न मान के रूप में, फ़ंक्शन एक Std_ReturnType प्रदान करता है [SWS_EthIf_91114]:
E_OK: डुप्लेक्स मोड को सफलतापूर्वक क्वेरी कर लिया गया औरDuplexModePtrके माध्यम से उपलब्ध कराया गया [SWS_EthIf_91114]।E_NOT_OK: निर्धारण विफल रहा, विनिर्देश के अनुसार उदाहरण के लिए यदि ट्रांसीवर को प्रारंभ नहीं किया जा सका [SWS_EthIf_91114]।
सीमाएँ और समवर्तीता (concurrency)
चूँकि इंटरफ़ेस गैर-पुनःप्रवेशी है, इसलिए बाहरी तुल्यकालन (external synchronization) के बिना समान या विभिन्न ट्रांसीवर इंस्टेंसेस के लिए समानांतर कॉल्स नहीं किए जाने चाहिए। घोषणा हेडर EthIf.h के माध्यम से उपलब्ध है [SWS_EthIf_91114]।
यह उपयोग नोट AUTOSAR R20-11 विनिर्देश डेटा के आधार पर स्वचालित रूप से तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SwitchPortGetCounterValues [SWS_EthIf_91115] 📄 PDF
Std_ReturnType EthIf_SwitchPortGetCounterValues (uint8 SwitchIdx, thernetInterface uint8 SwitchPortIdx, Eth_CounterType* CounterPtr); ⚠️
Reads a list with drop counter values of the corresponding port of the switch. The meaning of these values is described at Eth_ Counter Type.
सिंक्रोनस फ़ंक्शन EthIf_SwitchPortGetCounterValues [SWS_EthIf_91115] के अनुसार एक विशिष्ट Ethernet स्विच पोर्ट के काउंटर मानों (Drop Counter) को पढ़ने का कार्य करता है। हेडर EthIf.h के माध्यम से प्रदान किया गया, यह फ़ंक्शन स्विच इंडेक्स SwitchIdx और पोर्ट इंडेक्स SwitchPortIdx प्राप्त करता है और पॉइंटर CounterPtr के माध्यम से काउंटर मानों को वापस लिखता है ([SWS_EthIf_91115])।
कार्यप्रणाली और अग्रेषण
[SWS_EthIf_00432] के अनुसार, EthIf_SwitchPortGetCounterValues अनुरोध को तुरंत संबंधित Ethernet स्विच ड्राइवर के फ़ंक्शन EthSwt_GetCounterValues को अग्रेषित करता है। लौटाए गए काउंटर मान IETF RFC 1757, RFC 1643 और RFC 2233 मानकों पर आधारित हैं, जिसमें सटीक सिमेंटिक अर्थ संरचना Eth_CounterType को सौंपा गया है ([SWS_EthIf_91115])।
रिटर्न मान और त्रुटि प्रबंधन
रिटर्न मान के रूप में, फ़ंक्शन Std_ReturnType प्रदान करता है ([SWS_EthIf_91115]):
E_OK: काउंटर मानों को पढ़ना सफल रहा ([SWS_EthIf_91115])।E_NOT_OK: काउंटर मानों को पढ़ते समय एक त्रुटि उत्पन्न हुई ([SWS_EthIf_91115])।
समवर्तीता और प्रतिबंध
फ़ंक्शन को नॉन-रीएंट्रेंट (Non Reentrant) के रूप में निर्दिष्ट किया गया है ([SWS_EthIf_91115])। इसलिए समवर्ती कॉलों को कॉलर स्तर पर सिंक्रोनाइज़ किया जाना चाहिए। व्याख्या: कॉलर संभवतः CounterPtr के लिए एक मान्य और पर्याप्त आकार के मेमोरी क्षेत्र के प्रावधान के लिए भी ज़िम्मेदार होना चाहिए, क्योंकि विनिर्देश में किसी आंतरिक बफ़र आवंटन का उल्लेख नहीं है। प्रश्न Q-140661eaa9693cce (खुला)
यह उपयोग निर्देश AUTOSAR स्पेसिफिकेशन R20-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SwitchPortGetRxStats [SWS_EthIf_91116] 📄 PDF
Std_ReturnType EthIf_SwitchPortGetRxStats (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_RxStatsType* RxStatsPtr);
Returns a list of statistic counters defined with E th_ Rx Tats Type. The majority of these Counters are derived from the IETF RFC2819.
उपयोग और सिमेंटिक्स
फ़ंक्शन EthIf_SwitchPortGetRxStats ([SWS_EthIf_91116]) Ethernet स्विच के किसी पोर्ट के लिए प्राप्ति सांख्यिकी काउंटरों (receive statistics counters) को क्वेरी करने का काम करता है। यह हेडर EthIf.h के माध्यम से उपलब्ध है और इसे सर्विस-ID 0x52 के अंतर्गत प्रबंधित किया जाता है ([SWS_EthIf_91116])।
कॉल के लिए निम्नलिखित पैरामीटर आवश्यक हैं ([SWS_EthIf_91116]):
SwitchIdx: Ethernet स्विच ड्राइवर के संदर्भ में Ethernet स्विच का इंडेक्स।SwitchPortIdx: एड्रेस किए गए स्विच पर पोर्ट का इंडेक्स।RxStatsPtr:Eth_RxStatsTypeप्रकार की संरचना (structure) का पॉइंटर, जिसमें काउंटर मान लिखे जाते हैं। इनमें से अधिकांश मान IETF RFC 2819 (Remote Network Monitoring Management Information Base) से लिए गए हैं।
रिटर्न मान और त्रुटि प्रबंधन
फ़ंक्शन परिणाम के रूप में एक Std_ReturnType प्रदान करता है ([SWS_EthIf_91116]):
E_OK: सांख्यिकी डेटा सफलतापूर्वक पढ़ लिया गया।E_NOT_OK: काउंटर मान निर्धारित नहीं किए जा सके ([SWS_EthIf_91116])। इस कॉल के लिए विशिष्ट DET या DEM त्रुटि संदेश निर्दिष्ट नहीं हैं।
समवर्तीता और प्रतिबंध
फ़ंक्शन को गैर-पुनःप्रवेशी (Non Reentrant) के रूप में वर्गीकृत किया गया है ([SWS_EthIf_91116])। चूँकि सिंक्रोनिसिटी को "Synchronous /Asynchronous" के रूप में निर्दिष्ट किया गया है, इसलिए वास्तविक ब्लॉकिंग व्यवहार अंतर्निहित Ethernet स्विच ड्राइवर के कार्यान्वयन पर निर्भर होने की संभावना है ([SWS_EthIf_91116])। प्रश्न Q-d1e839075bf42e7f (खुला) कॉलर्स को एक ही इंटरफ़ेस पर समानांतर एक्सेस से बचना चाहिए।
यह पाठ AUTOSAR R20-11 पर आधारित एक AI द्वारा जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SwitchPortGetTxStats [SWS_EthIf_91117] 📄 PDF
Std_ReturnType EthIf_SwitchPortGetTxStats (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_TxStatsType* TxStatsPtr);
Returns the list of Transmission Statistics out of IETF RFC1213 defined with Eth_ Tx Stats Type, where the maximal possible value shall denote an invalid value, e.g. this counter is not available.
फ़ंक्शन EthIf_SwitchPortGetTxStats Ethernet स्विच [SWS_EthIf_91117] के एक विशिष्ट पोर्ट के लिए IETF RFC1213 के अनुसार ट्रांसमिशन सांख्यिकी को पढ़ने का काम करता है। यह हेडर फ़ाइल EthIf.h के माध्यम से सर्विस-ID 0x53 के साथ उपलब्ध है [SWS_EthIf_91117]।
उपयोग और पैरामीटर
कॉल के समय स्विच इंडेक्स (SwitchIdx) और संबोधित स्विच पर पोर्ट इंडेक्स (SwitchPortIdx) इनपुट पैरामीटर के रूप में पास किए जाते हैं [SWS_EthIf_91117]। निर्धारित काउंटर मान Eth_TxStatsType* प्रकार के पॉइंटर TxStatsPtr के माध्यम से उपलब्ध कराए जाते हैं [SWS_EthIf_91117]। यदि कोई काउंटर उपलब्ध नहीं है या समर्थित नहीं है, तो काउंटर का अधिकतम संभव मान एक अमान्य मान का संकेत देता है [SWS_EthIf_91117]।
रिटर्न मान और त्रुटि प्रबंधन
फ़ंक्शन प्रकार Std_ReturnType की स्थिति लौटाता है [SWS_EthIf_91117]:
E_OK: ट्रांसमिशन सांख्यिकी सफलतापूर्वक निर्धारित की गई [SWS_EthIf_91117]।E_NOT_OK: ट्रांसमिशन सांख्यिकी प्राप्त नहीं की जा सकी [SWS_EthIf_91117]।
DET या DEM के लिए विशिष्ट त्रुटि कोड या संदेश स्रोतों में निर्दिष्ट नहीं हैं, इसलिए त्रुटि स्थितियों को मुख्य रूप से रिटर्न मान E_NOT_OK के माध्यम से नियंत्रित किया जाना चाहिए [SWS_EthIf_91117]।
समवर्तीता और प्रतिबंध
विनिर्देश के अनुसार, EthIf_SwitchPortGetTxStats को अतुल्यकालिक (Asynchronous) और गैर-पुनःप्रवेशी (Non Reentrant) के रूप में परिभाषित किया गया है [SWS_EthIf_91117]। पुन:प्रवेशिता (reentrancy) के अभाव के कारण, उच्च-स्तरीय तुल्यकालन के बिना समवर्ती कॉल्स नहीं किए जाने चाहिए [SWS_EthIf_91117]। चूँकि सेवा को अतुल्यकालिक घोषित किया गया है, इसलिए पास किए गए बफ़र TxStatsPtr को ऑपरेशन के पूरी तरह समाप्त होने तक मान्य रखा जाना आवश्यक होने की संभावना है (व्याख्या: अतुल्यकालिक क्वेरी में बफ़र स्थिरता) [SWS_EthIf_91117]। प्रश्न Q-8a14618d6990206b (खुला)
यह उपयोग नोट विनिर्देश SWS_EthIf_91117 के आधार पर स्वचालित रूप से तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SwitchPortGetTxErrorCounterValues [SWS_EthIf_91118] 📄 PDF
Std_ReturnType EthIf_SwitchPortGetTxErrorCounterValues (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_TxErrorCounterValuesType* TxStatsPtr);
Returns the list of Transmission Error Counters out of IETF RFC1213 and RFC16 defined with Eth_ Tx Error Counter Values Type, where the maximal possible value shall denote an invalid value, e.g. this counter is not available.
EthIf.h के माध्यम से प्रदान किया गया सिंक्रोनस फ़ंक्शन EthIf_SwitchPortGetTxErrorCounterValues (सर्विस ID 0x54) किसी Ethernet स्विच के एक पोर्ट के लिए ट्रांसमिशन त्रुटि काउंटरों की एक सूची पढ़ता है [SWS_EthIf_91118]। काउंटर IETF RFC1213 और RFC1643 की परिभाषाओं के अनुरूप हैं और आउटपुट पैरामीटर TxStatsPtr में Eth_TxErrorCounterValuesType प्रकार के माध्यम से प्रदान किए जाते हैं [SWS_EthIf_91118]।
कॉल करते समय, SwitchIdx ड्राइवर के संदर्भ में स्विच को एड्रेस करता है और SwitchPortIdx स्विच पर ठोस पोर्ट को एड्रेस करता है [SWS_EthIf_91118]। मानों के सफल निर्धारण पर फ़ंक्शन E_OK लौटाता है और यदि ट्रांसमिशन आँकड़े प्राप्त नहीं किए जा सके तो E_NOTOK लौटाता है [SWS_EthIf_91118]। एक काउंटर मान जो अधिकतम संभव मान लेता है, स्पष्ट रूप से एक अमान्य या अनुपलब्ध काउंटर को इंगित करता है [SWS_EthIf_91118]।
निष्पादन के प्रतिबंध के रूप में, यह निर्धारित किया गया है कि फ़ंक्शन नॉन-रीएंट्रेंट (Non Reentrant) है [SWS_EthIf_91118]। आर्किटेक्चरल नेटवर्क में, EthIf_SwitchPortGetTxErrorCounterValues कॉल को सीधे संबंधित Ethernet स्विच ड्राइवर के फ़ंक्शन EthSwt_GetTxErrorCounterValues को अग्रेषित करता है [SWS_EthIf_00438]।
यह पाठ AI द्वारा विनिर्देश आवश्यकताओं के आधार पर तैयार किया गया था।
फ़ंक्शन EthIf_SwitchPortGetMacLearningMode [SWS_EthIf_91119] 📄 PDF
Std_ReturnType EthIf_SwitchPortGetMacLearningMode (thernetInterface uint8 SwitchIdx, uint8 SwitchPortIdx, EthSwt_MacLearningType* MacLearningModePtr); ⚠️
Returns the MAC learning mode, i.e. 1.) HW learning enabled, 2.) Hardware l earning disabled, 3.) Software learning enabled. Note: This feature is hardware dependent, i.e. the switch hardware needs to support the different learning modes
फ़ंक्शन EthIf_SwitchPortGetMacLearningMode किसी विशिष्ट स्विच पोर्ट के लिए वर्तमान MAC लर्निंग मोड को क्वेरी करता है ([SWS_EthIf_91119])। निर्धारित किए जा सकने वाले मोड में हार्डवेयर लर्निंग सक्षम, हार्डवेयर लर्निंग अक्षम और सॉफ़्टवेयर लर्निंग सक्षम शामिल हैं ([SWS_EthIf_91119])। इस फ़ंक्शन की उपलब्धता हार्डवेयर पर निर्भर करती है, क्योंकि संबंधित स्विच हार्डवेयर को विभिन्न लर्निंग मोड का समर्थन करना चाहिए ([SWS_EthIf_91119])।
कॉल संदर्भ और पैरामीटर
इंटरफ़ेस हेडर EthIf.h के माध्यम से प्रदान किया जाता है और इसकी सर्विस-ID 0x55 है ([SWS_EthIf_91119])। कॉल करते समय निम्नलिखित पैरामीटर पास किए जाने चाहिए:
SwitchIdx(in): Ethernet स्विच ड्राइवर के संदर्भ में स्विच का इंडेक्स ([SWS_EthIf_91119])।SwitchPortIdx(in): संबोधित स्विच पर पोर्ट का इंडेक्स ([SWS_EthIf_91119])।MacLearningModePtr(out):EthSwt_MacLearningTypeप्रकार के मेमोरी स्थान का पॉइंटर, जहाँ निर्धारित मोड संग्रहीत किया जाता है ([SWS_EthIf_91119])।
तुल्यकालन, समवर्तीता और रिटर्न मान
निष्पादन को तुल्यकालिक/अतुल्यकालिक के रूप में निर्दिष्ट किया गया है और यह गैर-पुनःप्रवेशी (Non Reentrant) है ([SWS_EthIf_91119])। रिटर्न मान के रूप में Std_ReturnType निम्नलिखित स्थितियों के साथ कार्य करता है:
E_OK: क्वेरी सफलतापूर्वक निष्पादित हुई ([SWS_EthIf_91119])।E_NOT_OK: निष्पादन में त्रुटि ([SWS_EthIf_91119])। यद्यपिE_NOT_OKके विनिर्देश विवरण में शाब्दिक रूप से "configuration could be persistently reset" कहा गया है, व्याख्या: यह विनिर्देश में एक संपादकीय प्रतिलिपि त्रुटि होने की संभावना है और नियमित संदर्भ में यह केवल क्वेरी की विफलता का संकेत देता है। प्रश्न Q-7565d2fbd70e355d (खुला)
यह पाठ AUTOSAR विनिर्देश R20-11 के आधार पर AI द्वारा उत्पन्न किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_GetSwitchPortIdentifier [SWS_EthIf_91120] 📄 PDF
Std_ReturnType EthIf_GetSwitchPortIdentifier (uint8 SwitchIdx, uint8 SwitchPortIdx, uint32* OrgUniqueIdPtr, uint8* ModelNrPtr, uint8* RevisionNrPtr);
This function retrieves the OUI (24 bit) of the indexed Ethernet switch port.
फ़ंक्शन EthIf_GetSwitchIdentifier [SWS_EthIf_91121] 📄 PDF
Std_ReturnType EthIf_GetSwitchIdentifier (uint8 SwitchIdx, uint32* OrgUniqueIdPtr);
Obtain the Organizationally Unique Identifier that is given by the IEEE of the indexed Ethernet switch. This function shall provide the OUI of Ethernet switch. The OUI has a size of 24 bit. If a ethernet switch can provide the OUI the 8 most significant bits of the OUI shall be set to 0x00xxxxxx. If a Ethernet switch can not provide the OUI the 8 most significant bits of the OUI shall be set to 0x FFxxxxxx. Availa ble via Eth If.h
फ़ंक्शन EthIf_WritePortMirrorConfiguration [SWS_EthIf_91122] 📄 PDF
Std_ReturnType EthIf_WritePortMirrorConfiguration (uint8 MirroredSwitchIdx, const EthSwt_PortMirrorCfgType* PortMirrorConfigurationPtr);
Service EthIf_WritePortMirrorConfiguration.
तुल्यकालिक इंटरफ़ेस EthIf_WritePortMirrorConfiguration Ethernet स्विच ड्राइवर [SWS_EthIf_91122] के भीतर एक शैडो बफ़र में पोर्ट मिररिंग कॉन्फ़िगरेशन को संग्रहीत करने का काम करता है।
कॉल के समय निम्नलिखित इनपुट पैरामीटर पास किए जाते हैं [SWS_EthIf_91122]:
MirroredSwitchIdx: Ethernet स्विच ड्राइवर के संदर्भ में संबंधित स्विच का इंडेक्स, जिस पर मिरर किया जाने वाला स्विच पोर्ट स्थित है [SWS_EthIf_91122]।PortMirrorConfigurationPtr: संरचनाEthSwt_PortMirrorCfgTypeके कॉन्फ़िगरेशन डेटा का पॉइंटर [SWS_EthIf_91122]।
प्रकार Std_ReturnType का रिटर्न मान निष्पादन की स्थिति का संकेत देता है [SWS_EthIf_91122]:
E_OK: पोर्ट मिररिंग कॉन्फ़िगरेशन अनुक्रमित पोर्ट के लिए सफलतापूर्वक लिखा गया [SWS_EthIf_91122]।E_NOT_OK: कॉन्फ़िगरेशन नहीं लिखा जा सका, उदाहरण के लिए क्योंकि अनुक्रमित स्विच उपलब्ध नहीं है [SWS_EthIf_91122]।ETHSWT_PORT_MIRRORING_CONFIGURATION_NOT_SUPPORTED: पोर्ट मिररिंग स्विच हार्डवेयर या Ethernet स्विच ड्राइवर द्वारा समर्थित नहीं है [SWS_EthIf_91122]।
फ़ंक्शन को गैर-पुनःप्रवेशी (Non Reentrant) के रूप में निर्दिष्ट किया गया है और यह हेडर EthIf.h के माध्यम से उपलब्ध है [SWS_EthIf_91122]। व्याख्या: कॉलर्स को उच्च-स्तरीय तंत्रों द्वारा समवर्ती एक्सेस को समन्वित करने की आवश्यकता होने की संभावना है, क्योंकि कोई आंतरिक तुल्यकालन सुरक्षा निर्दिष्ट नहीं है। प्रश्न Q-c731aedd871251a4 (खुला)
यह पाठ AI द्वारा उत्पन्न किया गया था और पूरी तरह से SWS_EthIf_91122 की विनिर्देश आवश्यकताओं पर आधारित है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_ReadPortMirrorConfiguration [SWS_EthIf_91123] 📄 PDF
Std_ReturnType EthIf_ReadPortMirrorConfiguration (uint8 MirroredSwitchIdx, EthSwt_PortMirrorCfgType* PortMirrorConfigurationPtr);
Obtain the port mirror configuration of the given Ethernet switch.
उपयोग और सिमेंटिक्स
फ़ंक्शन EthIf_ReadPortMirrorConfiguration किसी विशिष्ट Ethernet स्विच के पोर्ट मिररिंग कॉन्फ़िगरेशन को क्वेरी करने का काम करता है [SWS_EthIf_91123]। यह हेडर फ़ाइल EthIf.h में घोषित है और इसकी सर्विस-ID 0x59 है। निष्पादन व्यवहार को अतुल्यकालिक (Asynchronous) के रूप में निर्दिष्ट किया गया है, जहाँ तात्कालिक कॉल Std_ReturnType प्रकार का स्थिति मान लौटाता है [SWS_EthIf_91123]।
पैरामीटर और रिटर्न मान
MirroredSwitchIdx(in): Ethernet स्विच ड्राइवर के संदर्भ में Ethernet स्विच का इंडेक्स, जिस पर मिरर किए जाने वाले स्विच पोर्ट स्थित हैं [SWS_EthIf_91123]।PortMirrorConfigurationPtr(out): उस मेमोरी क्षेत्र का पॉइंटर, जिसमें पढ़ा गया कॉन्फ़िगरेशन संग्रहीत किया जाना है [SWS_EthIf_91123]।- रिटर्न मान:
E_OKकॉन्फ़िगरेशन को सफलतापूर्वक पढ़ने का संकेत देता है। त्रुटि की स्थिति मेंE_NOT_OKलौटाया जाता है, उदाहरण के लिए यदि अनुक्रमित Ethernet स्विच उपलब्ध नहीं है [SWS_EthIf_91123]।
परस्पर क्रिया और समवर्तिता (Concurrency)
निष्पादन के लिए, EthIf_ReadPortMirrorConfiguration कॉल को सीधे संबंधित Ethernet स्विच ड्राइवर के फ़ंक्शन EthSwt_ReadPortMirrorConfiguration पर अग्रेषित करता है [SWS_EthIf_00448]। फ़ंक्शन को गैर-पुनःप्रवेशी (Non Reentrant) के रूप में परिभाषित किया गया है [SWS_EthIf_91123]; इसलिए कॉलर द्वारा उसी इंटरफ़ेस के लिए समानांतर कॉल्स से बचना चाहिए।
यह उपयोग नोट AUTOSAR क्लासिक प्लेटफ़ॉर्म R20-11 के विनिर्देशों पर आधारित है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_DeletePortMirrorConfiguration [SWS_EthIf_91124] 📄 PDF
Std_ReturnType EthIf_DeletePortMirrorConfiguration (uint8 MirroredSwitchIdx);
Delete the stored port mirror configuration of the given Mirrored Switch Idx. If no port mirror configuration was found for the given Mirrored Switch Idx, the return value shall be E_ OK.
तुल्यकालिक फ़ंक्शन EthIf_DeletePortMirrorConfiguration किसी विशिष्ट स्विच ([SWS_EthIf_91124]) के लिए संग्रहीत पोर्ट मिरर कॉन्फ़िगरेशन को हटाने का काम करता है। कॉलर पैरामीटर Mirrored Switch Idx के माध्यम से Ethernet Switch Driver ([SWS_EthIf_91124]) के संदर्भ में स्विच का इंडेक्स पास करता है। इंटरफ़ेस की सर्विस-ID 0x5a है और इसे हेडर फ़ाइल EthIf.h के माध्यम से प्रदान किया जाता है ([SWS_EthIf_91124])।
प्रकार Std_ReturnType का रिटर्न मान हटाने के परिणाम की सूचना देता है ([SWS_EthIf_91124]):
E_OK: पोर्ट मिरर कॉन्फ़िगरेशन सफलतापूर्वक हटा दिया गया ([SWS_EthIf_91124])। यदि निर्दिष्ट स्विच इंडेक्स के लिए कोई संग्रहीत कॉन्फ़िगरेशन नहीं मिला, तो फ़ंक्शन परिभाषा के अनुसारE_OKभी लौटाता है ([SWS_EthIf_91124])।E_NOT_OK: कॉन्फ़िगरेशन को हटाना विफल रहा ([SWS_EthIf_91124])। यह उदाहरण के लिए तब होता है जब कॉल के समय पोर्ट मिररिंग अभी भी सक्रिय हो ([SWS_EthIf_91124])।
समवर्तीता के संबंध में, फ़ंक्शन विभिन्न स्विच इंडेक्स के लिए पुनःप्रवेशी (reentrant) है (Mirrored Switch Idx), लेकिन समान इंडेक्स के लिए एकाधिक कॉल्स पर गैर-पुनःप्रवेशी (non-reentrant) है ([SWS_EthIf_91124])। चूँकि सक्रिय मिररिंग को स्पष्ट रूप से E_NOT_OK के त्रुटि कारण के रूप में नामित किया गया है, इसलिए कॉन्फ़िगरेशन को हटाने से पहले पोर्ट मिररिंग को निष्क्रिय करना आवश्यक होने की संभावना है ([SWS_EthIf_91124])। प्रश्न Q-b9e5665de687dbba (खुला)
यह उपयोग संबंधी निर्देश AUTOSAR R20-11 के विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_GetPortMirrorState [SWS_EthIf_91125] 📄 PDF
Std_ReturnType EthIf_GetPortMirrorState (uint8 SwitchIdx, uint8 PortIdx, EthSwt_PortMirrorStateType* PortMirrorStatePtr);
Obtain the current status of the port mirroring for the indexed Ethernet switch port
फ़ंक्शन EthIf_SetPortMirrorState [SWS_EthIf_91126] 📄 PDF
Std_ReturnType EthIf_SetPortMirrorState (uint8 MirroredSwitchIdx, uint8 PortIdx, EthSwt_PortMirrorStateType PortMirrorState);
Request to set the given port mirroring state of the port mirror configuration for the given Ethernet switch.
तुल्यकालिक फ़ंक्शन EthIf_SetPortMirrorState किसी निर्दिष्ट Ethernet स्विच के लिए पोर्ट मिररिंग कॉन्फ़िगरेशन की आवश्यक स्थिति सेट करने का काम करता है ([SWS_EthIf_91126])। यह हेडर फ़ाइल EthIf.h के माध्यम से उपलब्ध है ([SWS_EthIf_91126])।
फ़ंक्शन कॉल पर तीन पैरामीटर की अपेक्षा करता है ([SWS_EthIf_91126]):
MirroredSwitchIdx: Ethernet Switch Driver के संदर्भ में Ethernet स्विच का इंडेक्स, जिस पर सक्रिय या निष्क्रिय की जाने वाली पोर्ट-मिररिंग कॉन्फ़िगरेशन स्थित है।PortIdx: एड्रेस किए गए Ethernet स्विच पर पोर्ट का इंडेक्स।PortMirrorState: पोर्ट मिररिंग की अनुरोध की जाने वाली स्थिति, या तोPORT_MIRRORING_ENABLEDयाPORT_MIRRORING_DISABLED।
प्रकार Std_ReturnType का रिटर्न मान अनुरोध के परिणाम का संकेत देता है ([SWS_EthIf_91126]):
E_OK: निर्दिष्ट स्विच पोर्ट के लिए अनुरोधित स्थिति सफलतापूर्वक सेट कर दी गई।E_NOT_OK: सेट करना विफल रहा, उदाहरण के लिए यदि संबोधित स्विच उपलब्ध नहीं है या कोई पोर्ट मिररिंग कॉन्फ़िगरेशन मौजूद नहीं है।
निष्पादन तुल्यकालिक रूप से होता है और इसे गैर-पुनःप्रवेशी (Non Reentrant) के रूप में निर्दिष्ट किया गया है ([SWS_EthIf_91126])। स्तरित संरचना (layered architecture) में Ethernet Interface अग्रेषण का कार्य संभालता है: [SWS_EthIf_00454] के अनुसार, EthIf_SetPortMirrorState कॉल को सीधे संबंधित Ethernet Switch Driver के फ़ंक्शन EthSwt_SetPortMirrorState पर अग्रेषित करता है।
यह पाठ AUTOSAR विनिर्देश R20-11 के आधार पर AI द्वारा उत्पन्न किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SetPortTestMode [SWS_EthIf_91127] 📄 PDF
Std_ReturnType EthIf_SetPortTestMode (uint8 SwitchIdx, uint8 PortIdx, EthTrcv_PhyTestModeType Mode);
Activates a given test mode of the indexed Ethernet switch port.
फ़ंक्शन EthIf_SetPortTestMode Ethernet स्विच [SWS_EthIf_91127] के किसी अनुक्रमित पोर्ट पर पूर्व-निर्धारित परीक्षण मोड को सक्रिय करने का काम करता है। तुल्यकालिक सेवा हेडर EthIf.h के माध्यम से सर्विस-ID 0x5d के साथ उपलब्ध है [SWS_EthIf_91127]।
पैरामीटर और रिटर्न मान
परीक्षण मोड के कॉन्फ़िगरेशन के लिए, इंटरफ़ेस तीन इनपुट पैरामीटर की अपेक्षा करता है, जबकि कोई इनपुट/आउटपुट या केवल आउटपुट पैरामीटर मौजूद नहीं हैं [SWS_EthIf_91127]:
SwitchIdx(uint8): संबंधित Ethernet स्विच ड्राइवर [SWS_EthIf_91127] के संदर्भ में स्विच का इंडेक्स।PortIdx(uint8): एड्रेस किए गए Ethernet स्विच [SWS_EthIf_91127] पर पोर्ट का इंडेक्स।Mode(EthTrcv_PhyTestModeType): स्विच पोर्ट पर सक्रिय किया जाने वाला टेस्ट मोड [SWS_EthIf_91127]।
Std_ReturnType प्रकार का रिटर्न मान ऑपरेशन [SWS_EthIf_91127] की सफलता का संकेत देता है:
E_OK: इंडेक्स किए गए Ethernet स्विच पोर्ट के लिए पोर्ट टेस्ट मोड सफलतापूर्वक सेट कर दिया गया [SWS_EthIf_91127]।E_NOT_OK: पोर्ट टेस्ट मोड सेट करना सफल नहीं रहा, उदाहरण के लिए यदि एड्रेस किया गया Ethernet स्विच पोर्ट उपलब्ध नहीं है [SWS_EthIf_91127]।
समवर्तीता और परस्पर क्रिया
फ़ंक्शन को नॉन-रीएंट्रेंट (Non Reentrant) के रूप में निर्दिष्ट किया गया है और यह सिंक्रोनस रूप से कार्य करता है [SWS_EthIf_91127]। कॉल किए जाने पर, EthIf_SetPortTestMode अनुरोध को संबंधित Ethernet स्विच ड्राइवर के अंतर्निहित फ़ंक्शन EthSwt_SetPortTestMode पर सीधे अग्रेषित करता है [SWS_EthIf_00456]।
यह उपयोग संबंधी निर्देश AUTOSAR R20-11 के विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SetPortLoopbackMode [SWS_EthIf_91128] 📄 PDF
Std_ReturnType EthIf_SetPortLoopbackMode (uint8 SwitchIdx, uint8 PortIdx, EthTrcv_PhyLoopbackModeType Mode);
Activates a given test loop - back mode of the indexed Ethernet switch port.
उपयोग
फ़ंक्शन EthIf_SetPortLoopbackMode का उपयोग किसी Ethernet स्विच के इंडेक्स किए गए पोर्ट के लिए एक पूर्वनिर्धारित टेस्ट लूपबैक मोड को सक्रिय करने के लिए किया जाता है [SWS_EthIf_91128]। घोषणा हेडर फ़ाइल EthIf.h के माध्यम से प्रदान की जाती है [SWS_EthIf_91128]। कॉल करते समय निम्नलिखित इनपुट पैरामीटर पास किए जाते हैं:
SwitchIdx: Ethernet स्विच ड्राइवर [SWS_EthIf_91128] के संदर्भ में Ethernet स्विच का इंडेक्स।PortIdx: पूर्व में एड्रेस किए गए स्विच पर प्रभावित पोर्ट का इंडेक्स [SWS_EthIf_91128]।Mode:EthTrcv_PhyLoopbackModeTypeप्रकार का सक्रिय किया जाने वाला लूपबैक मोड [SWS_EthIf_91128]।
इंटरैक्शन और फ़ॉरवर्डिंग
यह फ़ंक्शन हार्डवेयर स्तर पर कॉन्फ़िगरेशन स्वयं नहीं करता है। इसके बजाय, EthIf_SetPortLoopbackMode कॉल को सीधे संबंधित Ethernet स्विच ड्राइवर के फ़ंक्शन EthSwt_SetPortLoopbackMode पर अग्रेषित करता है [SWS_EthIf_00458]।
त्रुटि प्रबंधन और रिटर्न मान
रिटर्न मान Std_ReturnType प्रकार का है [SWS_EthIf_91128]:
E_OK: Ethernet स्विच के इंडेक्स किए गए पोर्ट के लिए लूपबैक मोड सफलतापूर्वक सक्रिय कर दिया गया [SWS_EthIf_91128]।E_NOT_OK: सक्रियण विफल रहा, उदाहरण के लिए यदि इंडेक्स किया गया Ethernet स्विच पोर्ट उपलब्ध नहीं है [SWS_EthIf_91128]।
इस सर्विस के लिए विनिर्देश में DET या DEM के लिए विशिष्ट त्रुटि कोड सूचीबद्ध नहीं हैं।
समवर्तीता और प्रतिबंध
निष्पादन पूरी तरह से सिंक्रोनस होता है, और फ़ंक्शन को नॉन-रीएंट्रेंट (Non Reentrant) के रूप में निर्दिष्ट किया गया है [SWS_EthIf_91128]। समानांतर कॉल को कॉलर द्वारा रोका जाना चाहिए। व्याख्या: चूंकि यह टेस्ट मोड को स्विच करने से संबंधित है, इसलिए कॉल आमतौर पर टास्क स्तर पर इनिशियलाइज़ेशन, टेस्ट या डायग्नोसिस अनुक्रमों के संदर्भ में होनी चाहिए। प्रश्न Q-cb4575c4a1d9c48b (खुला)
यह पाठ विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SetPortTxMode [SWS_EthIf_91129] 📄 PDF
Std_ReturnType EthIf_SetPortTxMode (thernetInterface uint8 SwitchIdx, uint8 PortIdx, EthTrcv_PhyTxModeType Mode); ⚠️
Activates a given transmission mode of the indexed Ethernet switch port.
सिंक्रोनस फ़ंक्शन EthIf_SetPortTxMode किसी इंडेक्स किए गए Ethernet स्विच पोर्ट के लिए एक पूर्वनिर्धारित ट्रांसमिशन मोड को सक्रिय करता है [SWS_EthIf_91129]। यह हेडर फ़ाइल EthIf.h के माध्यम से उपलब्ध है और इसकी सर्विस ID 0x5f है [SWS_EthIf_91129]।
उपयोग
कॉल दो इंडेक्स के माध्यम से लक्षित पोर्ट को एड्रेस करता है और वांछित मोड पास करता है [SWS_EthIf_91129]:
SwitchIdx: Ethernet स्विच ड्राइवर के संदर्भ में स्विच का इंडेक्स।PortIdx: एड्रेस किए गए स्विच पर पोर्ट का इंडेक्स।Mode: प्रकारEthTrcv_PhyTxModeTypeका सक्रिय किया जाने वाला ट्रांसमिशन मोड।
फ़ंक्शन Std_ReturnType रिटर्न मान के रूप में निम्नलिखित प्रदान करता है [SWS_EthIf_91129]:
E_OK: इंडेक्स किए गए स्विच पोर्ट के लिए ट्रांसमिशन मोड सफलतापूर्वक सक्रिय कर दिया गया।E_NOT_OK: सक्रियण विफल रहा, उदाहरण के लिए यदि इंडेक्स किया गया स्विच पोर्ट उपलब्ध नहीं है।
समवर्तीता और प्रतिबंध
इंटरफ़ेस को नॉन-रीएंट्रेंट (Non Reentrant) के रूप में निर्दिष्ट किया गया है [SWS_EthIf_91129]। इसलिए कॉलिंग इंस्टेंसेस को यह सुनिश्चित करना होगा कि कोई समवर्ती कॉल न हो। फ़ंक्शन परिभाषा में विशिष्ट DET या DEM त्रुटि संदेश सूचीबद्ध नहीं हैं; विनिर्देश के अनुसार त्रुटि व्यवहार केवल E_NOT_OK लौटाने तक सीमित है [SWS_EthIf_91129]।
यह उपयोग नोट AUTOSAR Classic Release R20-11 के विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_GetPortCableDiagnosticsResult [SWS_EthIf_91130] 📄 PDF
Std_ReturnType EthIf_GetPortCableDiagnosticsResult (uint8 SwitchIdx, uint8 PortIdx, EthTrcv_CableDiagResultType* ResultPtr);
Retrieves the cable diagnostics result of the indexed Ethernet switch port respectively the referenced Ethernet Transceiver Driver.
फ़ंक्शन EthIf_RunPortCableDiagnostic [SWS_EthIf_91131] 📄 PDF
Std_ReturnType EthIf_RunPortCableDiagnostic (uint8 SwitchIdx, uint8 PortIdx);
Trigger the cable diagnostics of the given Ethernet Switch port (Port Idx) by calling Eth Trcv_ Run Cable Diagnostic of the referenced Ethernet transceiver.
उपयोग
एसिंक्रोनस इंटरफ़ेस EthIf_RunPortCableDiagnostic किसी Ethernet स्विच के चयनित पोर्ट के लिए केबल डायग्नोस्टिक्स शुरू करता है [SWS_EthIf_91131]। कॉल के दौरान, पैरामीटर SwitchIdx (Ethernet स्विच ड्राइवर के संदर्भ में स्विच का इंडेक्स) और PortIdx (स्विच पर एड्रेस किए गए पोर्ट का इंडेक्स) पास किए जाते हैं। जैसे ही केबल डायग्नोस्टिक्स के लिए ट्रिगर स्वीकार कर लिया जाता है, फ़ंक्शन E_OK लौटाता है; यदि अनुरोध अस्वीकार कर दिया जाता है, तो E_NOT_OK लौटाया जाता है [SWS_EthIf_91131]।
इंटरैक्शन और पूर्वापेक्षाएँ
EthIf_RunPortCableDiagnostic के निष्पादन पर, EthIf यह सुनिश्चित करने के लिए बाध्य है कि संबंधित EthIfController ऑपरेटिंग स्थिति ETH_MODE_ACTIVE में है [SWS_EthIf_00464]। इस शर्त के तहत, Ethernet Interface कॉल को संबंधित स्विच ड्राइवर के फ़ंक्शन EthSwt_RunPortCableDiagnostic पर अग्रेषित करता है [SWS_EthIf_00464]।
समवर्तीता और प्रतिबंध
यह फ़ंक्शन SwitchIdx और PortIdx के भिन्न मानों के लिए रीएंट्रेंट है [SWS_EthIf_91131]। इसके विपरीत, स्विच और पोर्ट इंडेक्स के समान जोड़ों के लिए कॉल को नॉन-रीएंट्रेंट के रूप में निर्दिष्ट किया गया है, जिसके कारण एक ही पोर्ट पर समानांतर निष्पादन से बचा जाना चाहिए।
यह उपयोग नोट AUTOSAR विनिर्देश R20-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_RunCableDiagnostic [SWS_EthIf_91132] 📄 PDF
Std_ReturnType EthIf_RunCableDiagnostic (uint8 TrcvIdx);
Trigger the cable diagnostics for the given Ethernet transceiver.
उपयोग
फ़ंक्शन EthIf_RunCableDiagnostic किसी निर्दिष्ट Ethernet ट्रांसीवर के लिए केबल डायग्नोस्टिक्स को ट्रिगर करता है [SWS_EthIf_91132]। इसे हेडर EthIf.h के माध्यम से प्रदान किया जाता है और सर्विस ID 0x62 के तहत प्रबंधित किया जाता है [SWS_EthIf_91132]। पासिंग पैरामीटर के रूप में TrcvIdx का उपयोग किया जाता है, जो Ethernet ट्रांसीवर ड्राइवर के संदर्भ में लक्षित ट्रांसीवर के इंडेक्स को मैप करता है [SWS_EthIf_91132]।
निष्पादन एसिंक्रोनस रूप से होता है [SWS_EthIf_91132]। Std_ReturnType प्रकार का रिटर्न मान ट्रिगर की स्वीकृति का संकेत देता है:
E_OK: केबल डायग्नोस्टिक्स का ट्रिगर सफलतापूर्वक स्वीकार कर लिया गया [SWS_EthIf_91132]।E_NOT_OK: ट्रिगर स्वीकार नहीं किया गया [SWS_EthIf_91132]।
त्रुटि प्रबंधन
यदि केबल डायग्नोस्टिक्स अस्वीकार कर दिया जाता है, तो फ़ंक्शन तुरंत E_NOT_OK लौटाता है [SWS_EthIf_91132]। इस विनिर्देश में इस फ़ंक्शन के लिए कोई विशिष्ट डेवलपमेंट या प्रोडक्शन त्रुटियां (DET/DEM) परिभाषित नहीं हैं।
समवर्तीता और प्रतिबंध
समवर्तीता (concurrency) के संबंध में, EthIf_RunCableDiagnostic भिन्न इंडेक्स (TrcvIdx) वाले कॉल के लिए रीएंट्रेंट है, लेकिन समान ट्रांसीवर इंडेक्स के लिए नॉन-रीएंट्रेंट है [SWS_EthIf_91132]। एक ही ट्रांसीवर पर एक साथ किए जाने वाले डायग्नोस्टिक अनुरोधों को कॉलर द्वारा रोका जाना चाहिए। व्याख्या: चूंकि फ़ंक्शन पूरी तरह से एसिंक्रोनस रूप से कार्य करता है और कोई परिणाम डेटा वापस नहीं लौटाता है, इसलिए डायग्नोस्टिक परिणाम का प्रावधान संभवतः एक अलग तंत्र के माध्यम से होना चाहिए। प्रश्न Q-c65c009cd2e00dea (खुला)
यह पाठ विनिर्देश SWS_EthIf_91132 के आधार पर एक AI द्वारा जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SwitchGetCfgDataRaw [SWS_EthIf_91133] 📄 PDF
Std_ReturnType EthIf_SwitchGetCfgDataRaw (uint8 SwitchIdx, uint32 Offset, uint16 Length, uint8* BufferPtr);
Retrieves the data in memory of the indexed Ethernet switch in variable length
इंटरफ़ेस फ़ंक्शन EthIf_SwitchGetCfgDataRaw का उपयोग किसी इंडेक्स किए गए Ethernet स्विच के कॉन्फ़िगरेशन या मेमोरी डेटा को परिवर्तनीय लंबाई में पढ़ने के लिए किया जाता है [SWS_EthIf_91133]। लेयर्ड मॉडल के ढांचे में, मॉड्यूल कॉल को स्वतंत्र रूप से प्रोसेस नहीं करता है, बल्कि इसे सीधे संबंधित Ethernet स्विच ड्राइवर के फ़ंक्शन EthSwt_GetCfgDataRaw पर अग्रेषित करता है [SWS_EthIf_00468]। फ़ंक्शन हेडर EthIf.h में घोषित है और इसकी सर्विस ID 0x63 है [SWS_EthIf_91133]।
कॉल और पैरामीटर
कॉल एसिंक्रोनस रूप से होता है और केवल रीड ऑपरेशन प्रारंभ करता है [SWS_EthIf_91133]। पैरामीटर के रूप में, फ़ंक्शन निम्नलिखित की अपेक्षा करता है:
SwitchIdx: Ethernet स्विच ड्राइवर के संदर्भ में Ethernet स्विच का इंडेक्स [SWS_EthIf_91133],Offset: Ethernet स्विच की मेमोरी में स्टार्ट ऑफसेट, जहां से रीड ऑपरेशन शुरू होता है [SWS_EthIf_91133],Length: पढ़े जाने और कॉपी किए जाने वाले डेटा बाइट्स की संख्या [SWS_EthIf_91133],BufferPtr: गंतव्य मेमोरी स्थान का पॉइंटर, जहां डेटा कॉपी किया जाना है [SWS_EthIf_91133]।
रिटर्न मान के रूप में, फ़ंक्शन E_OK लौटाता है यदि रीड ऑपरेशन सफलतापूर्वक शुरू कर दिया गया है [SWS_EthIf_91133]। यदि ऑपरेशन शुरू नहीं किया जा सकता है - उदाहरण के लिए यदि एड्रेस किया गया स्विच उपलब्ध नहीं है - तो E_NOT_OK रिपोर्ट किया जाता है [SWS_EthIf_91133]।
संगामिति
फ़ंक्शन को नॉन-रीएंट्रेंट (Non Reentrant) के रूप में परिभाषित किया गया है [SWS_EthIf_91133]। इसलिए कॉलर्स को यह सुनिश्चित करना होगा कि कॉल क्रमिक रूप से हों। व्याख्या: एसिंक्रोनस प्रकृति के कारण, संभवतः E_OK से वापसी पर बफ़र सामग्री अंतिम रूप से नहीं भरी होगी, बल्कि ड्राइवर द्वारा समय विलंब के साथ उपलब्ध कराई जाएगी। प्रश्न Q-0abda93fb8830dd4 (खुला)
यह उपयोग नोट विनिर्देश AUTOSAR CP R20-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SwitchGetCfgDataInfo [SWS_EthIf_91134] 📄 PDF
Std_ReturnType EthIf_SwitchGetCfgDataInfo (uint8 SwitchIdx, uint32* DataSizePtr, uint32* DataAdressPtr);
Retrieves the total size of data and the memory start address of the indexed Ethernet Switch.
फ़ंक्शन EthIf_SwitchGetCfgDataInfo किसी इंडेक्स किए गए Ethernet स्विच के लिए कॉन्फ़िगरेशन डेटा का कुल आकार और कॉन्फ़िगरेशन रजिस्टरों का प्रारंभिक पता निर्धारित करता है [SWS_EthIf_91134]। इंटरफ़ेस हेडर EthIf.h में घोषित है और सर्विस ID 0x64 के तहत प्रबंधित किया जाता है [SWS_EthIf_91134]।
फ़ंक्शन निम्नलिखित पैरामीटर लेता है [SWS_EthIf_91134]:
SwitchIdx(in): Ethernet स्विच ड्राइवर के संदर्भ में Ethernet स्विच का इंडेक्स।DataSizePtr(out): उस मेमोरी स्थान का पॉइंटर, जहां कॉन्फ़िगरेशन डेटा का कुल आकार कॉपी किया जाना है।DataAdressPtr(out): उस मेमोरी स्थान का पॉइंटर, जहां कॉन्फ़िगरेशन रजिस्टरों का प्रारंभिक पता कॉपी किया जाना है।
रिटर्न मान के रूप में, फ़ंक्शन E_OK लौटाता है यदि डेटा सफलतापूर्वक प्राप्त कर लिया गया है, या E_NOT_OK यदि ऑपरेशन विफल हो जाता है, उदाहरण के लिए क्योंकि इंडेक्स किया गया स्विच उपलब्ध नहीं है [SWS_EthIf_91134]। इस सर्विस के लिए वर्तमान विनिर्देश दायरे में DET या DEM के लिए विशिष्ट त्रुटि कोड परिभाषित नहीं हैं।
कॉल संदर्भ के लिए, फ़ंक्शन को रीएंट्रेंट और औपचारिक रूप से एसिंक्रोनस के रूप में निर्दिष्ट किया गया है [SWS_EthIf_91134]। चूंकि कोई कॉलबैक तंत्र निर्दिष्ट नहीं हैं, इसलिए E_OK की वापसी पर डेटा का प्रावधान तुरंत उपलब्ध होना चाहिए (व्याख्या: एसिंक्रोनस वर्गीकरण संभवतः आंतरिक ड्राइवर एक्सेस का संकेत देता है)। प्रश्न Q-bf49882a16548ea4 (खुला)
यह पाठ एक AI द्वारा जनरेट किया गया था और AUTOSAR मानक के विनिर्देशों पर आधारित है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SwitchPortGetMaxFIFOBufferFillLevel [SWS_EthIf_91135] 📄 PDF
Std_ReturnType EthIf_SwitchPortGetMaxFIFOBufferFillLevel (uint8 SwitchPortIdx, uint8 PortIdx, uint8 SwitchPortEgressFifoIdx, uint32* SwitchPortEgressFifoBufferLevelPtr);
Service EthIf_SwitchPortGetMaxFIFOBufferFillLevel.
उपयोग और कॉल
फ़ंक्शन EthIf_SwitchPortGetMaxFIFOBufferFillLevel किसी Ethernet स्विच के एक विशिष्ट इग्रेस (egress) पोर्ट के लिए अंतिम रीड एक्सेस के बाद से अधिकतम आवंटित FIFO बफ़र मेमोरी (बाइट्स में) निर्धारित करता है [SWS_EthIf_91135]। कॉल, उदाहरण के लिए, एक Complex Device Driver (CDD) द्वारा किया जा सकता है [SWS_EthIf_91135]। एड्रेसिंग के लिए, स्विच इंडेक्स (SwitchPortIdx), पोर्ट इंडेक्स (PortIdx) और FIFO इंडेक्स (SwitchPortEgressFifoIdx) पास किए जाते हैं। निर्धारित भराव स्तर उस मेमोरी क्षेत्र में लिखा जाता है जिसे SwitchPortEgressFifoBufferLevelPtr संदर्भित करता है [SWS_EthIf_91135]।
समवर्तीता और निष्पादन
फ़ंक्शन में एसिंक्रोनस निष्पादन सिमेंटिक्स है [SWS_EthIf_91135]। यह विभिन्न स्विच और पोर्ट इंडेक्स के लिए रीएंट्रेंट है, लेकिन SwitchPortIdx और PortIdx के समान संयोजन के लिए इसे समवर्ती रूप से कॉल नहीं किया जाना चाहिए [SWS_EthIf_91135]। एक साथ पॉइंटर पास करने के साथ एसिंक्रोनस सिमेंटिक्स के कारण, परिणाम के लिए संदर्भित मेमोरी क्षेत्र को संभवतः ऑपरेशन पूरा होने तक वैध रहना होगा। प्रश्न Q-c941ffec278a86cd (खुला)
त्रुटि प्रबंधन और ड्राइवर इंटरैक्शन
सफल पुनर्प्राप्ति पर, फ़ंक्शन E_OK लौटाता है, अन्यथा E_NOT_OK [SWS_EthIf_91135]। यदि स्विच हार्डवेयर अधिकतम FIFO बफ़र भराव स्तर के पोर्ट-आधारित निर्धारण का समर्थन नहीं करता है, तो गंतव्य पते SwitchPortEgressFifoBufferLevelPtr पर मान 0xFFFFFFFF पर सेट किया जाता है [SWS_EthIf_91135]। मॉड्यूल आगे के निष्पादन के लिए कॉल को संबंधित Ethernet स्विच ड्राइवर के ड्राइवर फ़ंक्शन EthSwt_GetMaxFIFOBufferFillLevel पर अग्रेषित करता है [SWS_EthIf_00472]।
यह पाठ विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।
फ़ंक्शन EthIf_TransceiverGetMacMethod [SWS_EthIf_91021] 📄 PDF
Std_ReturnType EthIf_TransceiverGetMacMethod (uint8* TrcvIdx, EthTrcv_MacMethodType* MacModePtr);
Obtains the media access mode of the transceiver. Tags: atp.Status=draft thernet Interface AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_EthernetInterface
उपयोग और सिमेंटिक्स
फ़ंक्शन EthIf_TransceiverGetMacMethod (सर्विस-ID 0x66) Ethernet ट्रांसीवर [SWS_EthIf_91021] की कॉन्फ़िगर की गई मीडिया एक्सेस विधि को सिंक्रोनस रूप से क्वेरी करने का काम करता है। यह हेडर फ़ाइल EthIf.h के माध्यम से उपलब्ध है और निम्नलिखित इंटरफ़ेस पैरामीटर्स का उपयोग करता है:
TrcvIdx(in): Ethernet ट्रांसीवर ड्राइवर [SWS_EthIf_91021] के संदर्भ में ट्रांसीवर का इंडेक्स।MacModePtr(out):EthTrcv_MacMethodTypeप्रकार की निर्धारित एक्सेस विधि के लिए मेमोरी लोकेशन का पॉइंटर [SWS_EthIf_91021]। मान्य परिणाम मानETHTRCV_MAC_TYPE_CSMA_CD(Carrier-Sense Multiple Access mit Collision Detection) औरETHTRCV_MAC_TYPE_PLCA(Physical Layer Collision Avoidance) हैं।
रिटर्न मान और त्रुटि प्रबंधन
रिटर्न मान के रूप में, इंटरफ़ेस Std_ReturnType प्रकार की स्थिति देता है [SWS_EthIf_91021]:
E_OK: मीडिया एक्सेस विधि सफलतापूर्वक पढ़ी गई औरMacModePtrके माध्यम से उपलब्ध कराई गई।E_NOT_OK: ट्रांसीवर को भेजा गया अनुरोध स्वीकार नहीं किया गया था [SWS_EthIf_91021]। इस सेवा के लिए विनिर्देश में विशिष्ट DET या DEM एरर कोड सूचीबद्ध नहीं हैं।
समवर्तीता और सीमांत शर्तें
निष्पादन सिंक्रोनस रूप से होता है, हालांकि फ़ंक्शन को नॉन-रीएंट्रेंट (Non Reentrant) निर्दिष्ट किया गया है [SWS_EthIf_91021]। इसलिए कॉलर द्वारा समान ड्राइवर संदर्भ के भीतर एक साथ या व्यवधान डालने वाले (interrupting) कॉल को बाहर रखा जाना चाहिए। इसके अतिरिक्त यह भी ध्यान दिया जाना चाहिए कि रिलीज़ R20-11 में इस सेवा को atp.Status=draft स्टेटस के साथ नामित किया गया है [SWS_EthIf_91021]।
यह उपयोग संबंधी निर्देश EthIf_TransceiverGetMacMethod के लिए AUTOSAR विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_RxIndication [SWS_EthIf_00085] 📄 PDF
void EthIf_RxIndication (uint8 CtrlIdx, Eth_FrameType FrameType, boolean IsBroadcast, const uint8* PhysAddrPtr, const Eth_DataType* DataPtr, uint16 LenByte);
Handles a received frame received by the indexed controller
उपयोग और सिमेंटिक्स
सिंक्रोनस फ़ंक्शन EthIf_RxIndication एक अनुक्रमित (indexed) भौतिक ईथरनेट कंट्रोलर के माध्यम से प्राप्त ईथरनेट फ़्रेम को संसाधित करता है [SWS_EthIf_00085]। इस सेवा का कोई रिटर्न मान नहीं होता है और यह ईथरनेट इंटरफ़ेस के भीतर प्राप्त डेटा के अग्रेषण को संभालती है [SWS_EthIf_00085]। व्याख्या: नए प्राप्त डेटा के पूरी तरह से उपलब्ध होते ही कॉल सामान्यतः अंतर्निहित ईथरनेट ड्राइवर (Eth) द्वारा किया जाना चाहिए। प्रश्न Q-c3d25d0b89e6cd7f (खुला)
पैरामीटर
आगे के प्रसंस्करण के लिए, यह फ़ंक्शन निम्नलिखित पैरामीटर स्वीकार करता है [SWS_EthIf_00085]:
CtrlIdx: ईथरनेट इंटरफ़ेस [SWS_EthIf_00085] के संदर्भ में भौतिक ईथरनेट कंट्रोलर का इंडेक्स।FrameType: प्राप्त ईथरनेट फ़्रेम का फ़्रेम प्रकार [SWS_EthIf_00085]।IsBroadcast: यह पहचान कि क्या यह एक ब्रॉडकास्ट-फ़्रेम है [SWS_EthIf_00085]।PhysAddrPtr: प्राप्त फ़्रेम के भौतिक स्रोत पते (नेटवर्क बाइट क्रम में MAC पता) का पॉइंटर [SWS_EthIf_00085]।DataPtr: प्राप्त फ़्रेम के पेलोड (Payload) का पॉइंटर [SWS_EthIf_00085]।LenByte: प्राप्त फ़्रेम में पेलोड डेटा की लंबाई बाइट्स में [SWS_EthIf_00085]।
समवर्तीता और प्रतिबंध
इंटरफ़ेस को नॉन-रीएंट्रेंट (Non Reentrant) घोषित किया गया है और यह सर्विस-ID 0x10 के तहत हेडर फ़ाइल EthIf.h के माध्यम से उपलब्ध है [SWS_EthIf_00085]। कॉल करने वालों को यह सुनिश्चित करना होगा कि कोई समवर्ती कॉल न हो। इस फ़ंक्शन के लिए विनिर्देश के दायरे में कोई विशिष्ट त्रुटि कोड, रिटर्न मान या DET/DEM संदेश निर्दिष्ट नहीं हैं।
यह पाठ स्वचालित रूप से जनरेट किया गया था। सभी विवरण पूरी तरह से वर्तमान AUTOSAR रिलीज़ के विनिर्देश डेटा पर आधारित हैं।
फ़ंक्शन EthIf_TxConfirmation [SWS_EthIf_00091] 📄 PDF
void EthIf_TxConfirmation (uint8 CtrlIdx, Eth_BufIdxType BufIdx, Std_ReturnType Result);
Confirms frame transmission by the indexed controller
उपयोग और कॉल संदर्भ
सिंक्रोनस फ़ंक्शन EthIf_TxConfirmation (सर्विस-ID 0x11) CtrlIdx द्वारा संदर्भित भौतिक ईथरनेट कंट्रोलर के माध्यम से ईथरनेट फ़्रेम के प्रसारण की पुष्टि करता है [SWS_EthIf_00091]। फ़ंक्शन का कोई रिटर्न मान नहीं होता है और यह हेडर फ़ाइल EthIf.h के माध्यम से उपलब्ध है [SWS_EthIf_00091]।
इनपुट पैरामीटर निम्नानुसार परिभाषित हैं [SWS_EthIf_00091]:
CtrlIdx(uint8): ईथरनेट इंटरफ़ेस के संदर्भ में भौतिक ईथरनेट कंट्रोलर का इंडेक्स।BufIdx(Eth_BufIdxType): प्रेषित बफ़र का इंडेक्स।Result(Std_ReturnType): ट्रांसमिशन का परिणाम;E_OKएक सफल ट्रांसमिशन प्रक्रिया का संकेत देता है,E_NOT_OKएक ट्रांसमिशन त्रुटि का।
उच्चतर परतों के साथ सहक्रियाशीलता (interaction)
[SWS_EthIf_00255] के अनुसार, EthIf_TxConfirmation प्राप्त ट्रांसमिशन परिणाम Result को उसके कॉलबैक <UL>_TxConfirmation के माध्यम से कॉन्फ़िगर की गई ऊपरी परत पर अग्रेषित करता है।
समवर्तीता और प्रतिबंध
फ़ंक्शन को नॉन-रीएंट्रेंट (Non Reentrant) के रूप में निर्दिष्ट किया गया है [SWS_EthIf_00091]। इसलिए समवर्ती कॉल से बचा जाना चाहिए। विशिष्ट DET या DEM त्रुटि संदेश विनिर्देश उद्धरण में प्रदान नहीं किए गए हैं; त्रुटियाँ केवल E_NOT_OK मान वाले पैरामीटर Result के माध्यम से संप्रेषित की जाती हैं [SWS_EthIf_00091]।
यह पाठ किसी AI द्वारा स्वचालित रूप से तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_CtrlModeIndication [SWS_EthIf_00231] 📄 PDF
void EthIf_CtrlModeIndication (uint8 CtrlIdx, thernetInterface Eth_ModeType CtrlMode); ⚠️
Called asynchronously when mode has been read out. Triggered by previous Eth_ Set Controller Mode call. Can directly be called within the trigger functions.
जैसे ही ईथरनेट कंट्रोलर का ऑपरेटिंग मोड सफलतापूर्वक रीड कर लिया जाता है, [SWS_EthIf_00231] के अनुसार नोटिफिकेशन फ़ंक्शन EthIf_CtrlModeIndication को कॉल किया जाता है। Eth_SetControllerMode के पिछले कॉल के परिणामस्वरूप यह ट्रिगर एसिंक्रोनस रूप से होता है, जहाँ यह कॉल सीधे संबंधित ट्रिगर फ़ंक्शन्स के भीतर हो सकता है। फ़ंक्शन का निष्पादन सिमेंटिक्स स्वयं सिंक्रोनस होता है और यह कोई रिटर्न वैल्यू नहीं देता है ([SWS_EthIf_00231])।
पैरामीटर्स के माध्यम से ईथरनेट इंटरफ़ेस के संदर्भ में फ़िज़िकल ईथरनेट कंट्रोलर का इंडेक्स (CtrlIdx) और रिपोर्ट किया गया कंट्रोलर मोड (CtrlMode) पास किए जाते हैं ([SWS_EthIf_00231])। कॉनक्रेन्सी के संबंध में, [SWS_EthIf_00231] निर्दिष्ट करता है कि फ़ंक्शन समान कंट्रोलर इंडेक्स के लिए नॉन-रीएंट्रेंट है, लेकिन विभिन्न इंडेक्स के लिए इसे रीएंट्रेंट रूप से निष्पादित किया जा सकता है।
अन्य मॉड्यूल्स के साथ इंटरैक्शन के संबंध में, संबंधित आवश्यकताएं डाउनस्ट्रीम क्रियाओं का संदर्भ देती हैं, जिन्हें हालांकि वर्तमान रिलीज़ में अप्रचलित (obsolete) माना गया है:
- [SWS_EthIf_00267] (OBSOLETE) के अनुसार, इस फ़ंक्शन के संदर्भ में स्विच-पोर्ट समूह के सभी पोर्ट्स के लिए
EthSwt_SetSwitchPortModeको कॉल करना अपेक्षित था, यदि कोई संबंधित कंट्रोल संदर्भ मौजूद हो, औरETH_MODE_DOWNपर सक्रिय समूहों के साथ होने वाले विवादों को हल करना था। - [SWS_EthIf_00413] (OBSOLETE) के अनुसार, इस फ़ंक्शन के संदर्भ में ट्रांसीवर संदर्भ उपस्थित होने पर
ETHTRCV_LINK_STATE_ACTIVEयाETHTRCV_LINK_STATE_DOWNके साथEthTrcv_TransceiverLinkStateRequestको कॉल करना अपेक्षित था, जो इस बात पर निर्भर करता था कि पहलेETH_MODE_ACTIVEयाETH_MODE_DOWNका अनुरोध किया गया था या नहीं।
यह पाठ AUTOSAR CP R20-11 विनिर्देश के आधार पर एक AI द्वारा तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_TrcvModeIndication [SWS_EthIf_00232] 📄 PDF
void EthIf_TrcvModeIndication (uint8 TrcvIdx, Eth_ModeType TrcvMode);
Called asynchronously when a mode change has been read out. If the function is triggered by previous call of Eth Trcv_ Set Transceiver Mode it can directly be called within the trigger function. Ava ilable via Eth If.h
उपयोग और सिमेंटिक्स
फ़ंक्शन EthIf_TrcvModeIndication ईथरनेट इंटरफ़ेस के एक अधिसूचना इंटरफ़ेस के रूप में कार्य करता है, जिसे ट्रांसीवर के मोड परिवर्तन को पढ़े जाने पर तुरंत कॉल किया जाता है [SWS_EthIf_00232]। यह हेडर फ़ाइल EthIf.h के माध्यम से उपलब्ध है और इसमें सर्विस-ID 0x0f है [SWS_EthIf_00232]।
फ़ंक्शन का निष्पादन स्वयं सिंक्रोनस रूप से निर्दिष्ट किया गया है, जबकि कॉल एसिंक्रोनस रूप से होता है जब मोड परिवर्तन निर्धारित किया गया हो [SWS_EthIf_00232]। यदि फ़ंक्शन EthTrcv_SetTransceiverMode के पिछले कॉल द्वारा ट्रिगर किया जाता है, तो इसे सीधे इस ट्रिगरिंग फ़ंक्शन के भीतर कॉल किया जा सकता है [SWS_EthIf_00232]।
पैरामीटर और रिटर्न मान
TrcvIdx: ईथरनेट इंटरफ़ेस के संदर्भ में ईथरनेट ट्रांसीवर का इंडेक्स (इनपुट पैरामीटर) [SWS_EthIf_00232]।TrcvMode: प्रकारEth_ModeTypeके ईथरनेट ट्रांसीवर का संकेतित ऑपरेटिंग मोड (इनपुट पैरामीटर) [SWS_EthIf_00232]।- रिटर्न मान: कोई नहीं (
void) [SWS_EthIf_00232]।
कन्करेंसी और रीएंट्रेंसी
यह फ़ंक्शन समान इंडेक्स के लिए नॉन-रीएंट्रेंट है, जबकि भिन्न इंडेक्स के लिए रीएंट्रेंट निर्दिष्ट है [SWS_EthIf_00232]। विनिर्देश तालिका यहाँ Ctrl Idx का उल्लेख करती है, जिसे इस ट्रांसीवर इंटरफ़ेस के संदर्भ में संभवतः ट्रांसीवर या कंट्रोलर इंडेक्स के संदर्भ के रूप में व्याख्यायित किया जाना चाहिए [SWS_EthIf_00232]। प्रश्न Q-c0123f1ef0e4ec71 (खुला)
यह उपयोग नोट विनिर्देश AUTOSAR CP R20-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SwitchPortModeIndication [SWS_EthIf_91055] 📄 PDF
void EthIf_SwitchPortModeIndication (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_ModeType PortMode);
The Eth If shall determine the expected notifications based on the Eth Swt Port configuration. In case the Eth Swt Port references an Eth Trcv the Eth If expects a notification from the Eth Trcv via API Eth If_ Trcv Mode Indication(). Otherwise the Eth If expects a notification from the Eth Swt via API Eth If_ Switch Port Mode Indication()
फ़ंक्शन EthIf_SwitchPortModeIndication Ethernet स्विच ड्राइवर [SWS_EthIf_91055] द्वारा रिपोर्ट किए गए Ethernet स्विच पोर्ट के मोड परिवर्तन के बारे में Ethernet Interface (EthIf) के लिए एक एसिंक्रोनस नोटिफ़िकेशन इंटरफ़ेस के रूप में कार्य करता है।
उपयोग और अंतःक्रिया
EthIf संबंधित स्विच पोर्ट के कॉन्फ़िगरेशन के आधार पर अपेक्षित नोटिफ़िकेशन निर्धारित करता है: यदि स्विच पोर्ट किसी ट्रांसीवर (EthTrcv) को संदर्भित करता है, तो EthIf इसके बजाय EthIf_TrcvModeIndication() के माध्यम से नोटिफ़िकेशन की अपेक्षा करता है; अन्यथा Ethernet स्विच ड्राइवर से EthIf_SwitchPortModeIndication() के माध्यम से नोटिफ़िकेशन की अपेक्षा की जाती है [SWS_EthIf_91055]।
SwitchIdx: Ethernet स्विच ड्राइवर [SWS_EthIf_91055] के संदर्भ में Ethernet स्विच का इंडेक्स।SwitchPortIdx: एड्रेस किए गए Ethernet स्विच [SWS_EthIf_91055] पर पोर्ट का इंडेक्स।PortMode: स्विच पोर्ट काEth_ModeTypeप्रकार का नया रिपोर्ट किया गया मोड [SWS_EthIf_91055]।
निष्पादन विशेषताएँ और सीमाएँ
फ़ंक्शन का कोई रिटर्न मान (void) नहीं है और सर्विस-ID 0x46 [SWS_EthIf_91055] है। इसे एसिंक्रोनस (Asynchronous) और नॉन-रीएंट्रेंट (Non Reentrant) के रूप में निर्दिष्ट किया गया है [SWS_EthIf_91055]। इसलिए कॉलर्स को यह सुनिश्चित करना चाहिए कि इस सेवा के लिए समवर्ती कॉल्स से बचा जाए। इस फ़ंक्शन के लिए पेलोड में विशिष्ट DET या DEM त्रुटि संदेश परिभाषित नहीं हैं।
यह उपयोग नोट विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_SleepIndication [SWS_EthIf_91006] 📄 PDF
void EthIf_SleepIndication (uint8 TrcvIdx);
This API is called by the corresponding Eth Trcv, if a sleep indication was detected on the network. This could be used e.g. for Ethernet hardware which is compliant to the OA TC10. In this ca se the Ethernet hardware (PHY) detect an Sleep.Indication which was triggered by a Sleep.Request of the connected link partner. Tags: atp.Status=draft
उपयोग और कॉल संदर्भ
फ़ंक्शन EthIf_SleepIndication Ethernet इंटरफ़ेस के नोटिफिकेशन इंटरफ़ेस के रूप में कार्य करता है। इसे संबंधित Ethernet ट्रांसीवर ड्राइवर (EthTrcv) द्वारा कॉल किया जाता है जैसे ही वह नेटवर्क पर स्लीप संकेत पंजीकृत करता है [SWS_EthIf_91006]। एकमात्र इनपुट पैरामीटर के रूप में TrcvIdx पास किया जाता है, जो मॉड्यूल EthIf के संदर्भ में संकेत देने वाले Ethernet ट्रांसीवर के इंडेक्स की विशिष्ट पहचान करता है [SWS_EthIf_91006]। फ़ंक्शन में न तो कोई इनपुट/आउटपुट मान है और न ही कोई रिटर्न मान, और यह नोटिफिकेशन को सिंक्रोनस रूप से निष्पादित करता है [SWS_EthIf_91006]।
हार्डवेयर इंटरैक्शन
एक प्रमुख उपयोग का मामला Ethernet हार्डवेयर के साथ उपयोग है जो OPEN Alliance TC10 विनिर्देश के अनुरूप डिज़ाइन किया गया है [SWS_EthIf_91006]। इस परिदृश्य में, ट्रांसीवर (PHY) हार्डवेयर स्तर पर एक Sleep.Indication का पता लगाता है, जो सीधे जुड़े लिंक पार्टनर के स्लीप अनुरोध (Sleep.Request) द्वारा ट्रिगर हुआ था [SWS_EthIf_91006]।
समवर्तीता और प्रतिबंध
इंटरफ़ेस को सिंक्रोनस और रीएंट्रेंट के रूप में परिभाषित किया गया है तथा हेडर फ़ाइल EthIf.h (सर्विस ID 0x68) के माध्यम से प्रदान किया जाता है [SWS_EthIf_91006]। सिस्टम इंटीग्रेशन के समय, यह ध्यान में रखा जाना चाहिए कि तत्व को atp.Status=draft टैग के साथ एक ड्राफ्ट के रूप में चिह्नित किया गया है [SWS_EthIf_91006]। विनिर्देश के दायरे में ठोस त्रुटि प्रबंधन रूटीन या DET त्रुटि कोड परिभाषित नहीं हैं; संभवतः एक औपचारिक त्रुटि जाँच भविष्य के विनिर्देश संस्करणों में ही होगी। प्रश्न Q-680af6c43439167f (खुला)
यह उपयोग निर्देश AUTOSAR R20-11 स्पेसिफिकेशन के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_MainFunctionRx [SWS_EthIf_00097] 📄 PDF
void EthIf_MainFunctionRx (void);
The function checks for new received frames and issues reception indications in polling mode.
उपयोग और कॉल संदर्भ
ईथरनेट इंटरफ़ेस (EthIf) में फ़ंक्शन EthIf_MainFunctionRx पोलिंग संचालन में नए प्राप्त डेटा फ्रेम की जाँच करने और ऊपरी परतों को संबंधित रिसेप्शन संकेत (Reception Indications) ट्रिगर करने का केंद्रीय कार्य संभालता है [SWS_EthIf_00097]। इसे सिग्नेचर void EthIf_MainFunctionRx (void) के साथ परिभाषित किया गया है, इसलिए यह कोई कॉल पैरामीटर स्वीकार नहीं करता है और कोई रिटर्न मान नहीं देता है [SWS_EthIf_00097]। हेक्साडेसिमल मान 0x20 को सर्विस-ID के रूप में निर्धारित किया गया है [SWS_EthIf_00097]।
फ़ंक्शन हेडर फ़ाइल SchM_EthIf.h के माध्यम से उपलब्ध कराया जाता है [SWS_EthIf_00097]। इससे यह व्याख्या सामने आती है कि इसका कॉल बेसिक सॉफ़्टवेयर के चक्रीय टास्क संदर्भ में Schedule Manager (SchM) या ऑपरेटिंग सिस्टम द्वारा समय-समय पर किया जाता है।
समवर्तीता और त्रुटि प्रबंधन
चूंकि प्राप्त फ्रेमों की जाँच और अग्रेषण पोलिंग मोड में निर्दिष्ट है [SWS_EthIf_00097], इसलिए सुचारू रिसेप्शन संचालन के लिए कॉल के पर्याप्त समय अंतराल की आवश्यकता होती है। विलंबित निष्पादन ऊपरी सॉफ़्टवेयर परतों को आने वाले संदेशों के अग्रेषण में देरी का कारण बन सकता है। प्रश्न Q-554ef0cf302c3aa3 (खुला) विनिर्देश में इस फ़ंक्शन के लिए कोई विशिष्ट त्रुटि कोड, विकास त्रुटियां (DET) या DEM को त्रुटि संदेश सूचीबद्ध नहीं हैं।
यह उपयोग नोट एक AI द्वारा उत्पन्न किया गया था और AUTOSAR CP R20-11 विनिर्देश स्थिति की आवश्यकताओं को सारांशित करता है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_MainFunctionTx [SWS_EthIf_00113] 📄 PDF
void EthIf_MainFunctionTx (void);
The function issues transmission confirmations in polling mode. It checks also for transceiver state changes.
मुख्य फ़ंक्शन EthIf_MainFunctionTx ईथरनेट इंटरफ़ेस मॉड्यूल [SWS_EthIf_00113] के भीतर ट्रांसमिशन संचालन और स्थिति प्रश्नों के चक्रीय प्रसंस्करण के लिए कार्य करता है। इसमें हेक्साडेसिमल सर्विस-ID 0x21 है और इसके सिग्नेचर void EthIf_MainFunctionTx (void) के अनुसार बिना किसी ट्रांसफर पैरामीटर और बिना रिटर्न मान के निष्पादित किया जाता है, ताकि संपूर्ण प्रसंस्करण स्थिति-आधारित हो [SWS_EthIf_00113]।
चालू संचालन में, सेवा ईथरनेट संचार में दो केंद्रीय कार्य संभालती है:
- ट्रांसमिशन पुष्टिकरण: पोलिंग मोड में, फ़ंक्शन ऊपरी परतों को सफलतापूर्वक पूर्ण किए गए ट्रांसमिशन (Transmission Confirmations) के लिए पुष्टिकरण प्रदान करता है [SWS_EthIf_00113]।
- ट्रांसीवर स्थितियां: यह कनेक्टेड ईथरनेट ट्रांसीवर के घटित स्थिति परिवर्तनों के लिए सिस्टम की निगरानी और जाँच करता है [SWS_EthIf_00113]।
सिस्टम एकीकरण के संबंध में, इंटरफ़ेस हेडर फ़ाइल SchM_EthIf.h के माध्यम से उपलब्ध है [SWS_EthIf_00113]। व्याख्या: SchM_EthIf.h के माध्यम से उपलब्धता से यह निष्कर्ष निकलता है कि कॉल BSW शेड्यूलर (SchM) द्वारा चक्रीय टास्क के संदर्भ में समय-समय पर किया जाना चाहिए। प्रश्न Q-b9dde07f9cc74a95 (खुला) यह सुनिश्चित करता है कि पोलिंग संचालन में लंबित ट्रांसमिशन पुष्टिकरण और ट्रांसीवर स्थिति परिवर्तन नियमित रूप से और इंटरप्ट निर्भरता के बिना संसाधित होते हैं।
विशिष्ट त्रुटि कोड, DET या DEM के माध्यम से अलग त्रुटि हैंडलिंग रूटीन और रीएंट्रेंसी आवश्यकताएं इस सेवा के लिए वर्तमान विनिर्देश के दायरे में परिभाषित नहीं हैं और इसलिए दिखाई नहीं गई हैं।
यह उपयोग निर्देश विनिर्देश AUTOSAR Classic रिलीज़ R20-11 के विनिर्देशों पर आधारित है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन EthIf_MainFunctionState [SWS_EthIf_91104] 📄 PDF
void EthIf_MainFunctionState (void);
The function is polling different communication hardware (Ethernet transceiver, Ethernet switch ports) related information, e.g. link state, signal quality.
उपयोग और सिमेंटिक्स
फ़ंक्शन EthIf_MainFunctionState कनेक्टेड Ethernet संचार हार्डवेयर, जैसे Ethernet ट्रांसीवर और Ethernet स्विच पोर्ट की स्थिति और डायग्नोस्टिक जानकारी की चक्रीय पोलिंग (polling) के लिए कार्य करता है [SWS_EthIf_91104]। इनमें उदाहरण के लिए कनेक्शन स्थिति (Link State) और सिग्नल गुणवत्ता शामिल हैं [SWS_EthIf_91104]। फ़ंक्शन में न तो इनपुट पैरामीटर हैं और न ही आउटपुट पैरामीटर, और यह कोई मान नहीं लौटाता है (void EthIf_MainFunctionState(void), सर्विस ID 0x05) [SWS_EthIf_91104]। निष्पादन व्यवहार को एसिंक्रोनस के रूप में निर्दिष्ट किया गया है [SWS_EthIf_91104]।
कन्करेंसी और कॉल स्थितियाँ
फ़ंक्शन को नॉन-रीएंट्रेंट (Non Reentrant) के रूप में परिभाषित किया गया है [SWS_EthIf_91104]। इसलिए इसे किसी भी समय समानांतर रूप से या स्वयं को बाधित करते हुए निष्पादित नहीं किया जाना चाहिए। चूँकि इंटरफ़ेस हेडर फ़ाइल EthIf_SchM.h के माध्यम से प्रदान किया जाता है [SWS_EthIf_91104], आवधिक कॉल आमतौर पर BSW शेड्यूलर (SchM) के टास्क संदर्भ में होनी चाहिए। प्रश्न Q-10d02355b276be90 (खुला)
इंटरेक्शन और कॉन्फ़िगरेशन
[SWS_EthIf_00407] के अनुसार, EthIf_MainFunctionState को कॉन्फ़िगर की गई आवधिकता EthIfMainFunctionStatePeriod के साथ हार्डवेयर जानकारी को सख्ती से पोल करना चाहिए। यह Ethernet इंटरफ़ेस में भौतिक इंटरफ़ेस मापदंडों के नियमित अद्यतन को सुनिश्चित करता है।
यह नोट AUTOSAR विनिर्देश के आधार पर एक AI द्वारा उत्पन्न किया गया था और यह किसी औपचारिक एकीकरण परीक्षण का स्थान नहीं लेता है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
टाइप EthIf_ConfigType [SWS_EthIf_00149] 📄 PDF
Implementation specific structure of the post build configuration
टाइप EthIf_SwitchPortGroupIdxType [SWS_EthIf_91101] 📄 PDF
Data Type that represents the Ethernet interface switch port group index. The index is zero based and unique for every configured switch port group.
टाइप EthIf_MeasurementIdxType [SWS_EthIf_91010] 📄 PDF
Index to select specific measurement data
टाइप EthIf_SignalQualityResultType [SWS_EthIf_91057] 📄 PDF
-
डेटा संरचना EthIf_SignalQualityResultType ([SWS_EthIf_91057]) ईथरनेट स्तर पर कनेक्शन गुणवत्ता के अधिग्रहण और डायग्नोस्टिक्स के लिए उपयोग की जाती है और हेडर फ़ाइल EthIf.h के माध्यम से प्रदान की जाती है।
संरचना बेस प्रकार uint32 के तीन मापे गए मानों को बंडल करती है:
ActualSignalQuality: ईथरनेट कनेक्शन की वर्तमान में लागू सिग्नल गुणवत्ता को दर्शाता है।HighestSignalQuality: अंतिम रीसेट के बाद से कनेक्शन की उच्चतम मापी गई सिग्नल गुणवत्ता को रिकॉर्ड करता है।LowestSignalQuality: अंतिम रीसेट के बाद से कनेक्शन की न्यूनतम मापी गई सिग्नल गुणवत्ता का दस्तावेज़ीकरण करता है।
मॉड्यूल EthIf के साथ मिलकर, चरम मान कनेक्शन स्थिरता के रुझान को दर्शाते हैं। आंतरिक रूप से संग्रहीत इतिहास मानों का रीसेट समर्पित इंटरफ़ेस के माध्यम से नियंत्रित किया जाता है:
TrcvIdxके माध्यम से निर्दिष्ट ट्रांसीवर के लिए, फ़ंक्शनEthIf_ClearTrcvSignalQualityसंग्रहीत सिग्नल गुणवत्ता मानों को रीसेट करता है ([SWS_EthIf_00400])।SwitchIdxऔरSwitchPortIdxके माध्यम से पहचाने गए स्विच पोर्ट के लिए,EthIf_ClearSwitchPortSignalQualityसंग्रहीत सिग्नल गुणवत्ता मानों को मिटा देता है ([SWS_EthIf_00404])।
व्याख्या: चूंकि पेलोड में किसी विशिष्ट रीड-फ़ंक्शन का उल्लेख नहीं है, इसलिए संभवतः यह संरचना ट्रांसीवर और स्विच पोर्ट्स के संबंधित स्टेटस प्रश्नों के लिए एक आउटपुट पैरामीटर के रूप में काम करती होगी, ताकि वर्तमान सिग्नल गुणवत्ता की तुलना चरम मानों के साथ की जा सके। प्रश्न Q-8e5f2914bade574c (खुला)
यह पाठ किसी AI द्वारा जनरेट किया गया था और पूरी तरह से R20-11 के विनिर्देशन संबंधी निर्देशों पर आधारित है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/CP_MOD_EthIf- Status
- unspecified
- Version
AUTOSAR/AP/record/CP_MOD_EthIf@rel:R20-11#f32d902c- Content hash
f32d902c- Source
- https://www.autosar.org/fileadmin/standards/R20-11/CP/AUTOSAR_SWS_EthernetInterface.pdf#nameddest=SWS_EthIf_00024
gemini-3.8-flash-low· 2026-10-13 · जर्मन मूल