DEENESPTFRRUARHIKOZHNL

Ethernet Interface (EthIf)

ModulEthIf (Ethernet Interface)
BSW-Modul-ID65
Standard-Header#include "EthIf.h"
SWS-SpezifikationAUTOSAR_SWS_EthernetInterface.pdf
ClusterEthernet Services

دليل الوحدةمولَّد بالذكاء الاصطناعي

يتوسط الأطر، وتغييرات الأوضاع، وحالات الاتصال (Link) بين برامج تشغيل Ethernet والمحولات وحزمة الاتصالات.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: claude-opus-5-5 · الجهد: high · درجة الحرارة: غير قابل للتحكم · الموجّه: c246974844fe المصدر أسئلة مفتوحة (2)
المرساة السببية: R20-11 صالح اعتبارًا من R20-11 مُركَّب حديثًا لهذا الإصدار من المواصفة.
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يتوسط الأطر، وتغييرات الأوضاع، وحالات الاتصال (Link) بين برامج تشغيل Ethernet والمحولات وحزمة الاتصالات.

تتوسط واجهة Ethernet Interface بين EthSM والطبقات العليا من جهة، وبرامج التشغيل لوحدات التحكم وأجهزة الإرسال والاستقبال والمحولات من جهة أخرى. عبر EthIf_SetControllerMode غير المتزامن، تقوم بتبديل وحدات التحكم مع الأجهزة المشار إليها [SWS_EthIf_00034]. ترسل الأطر في خطوتين، وتوزع إشعارات الاستقبال، وتبلغ عن حالات الارتباط إلى EthSM أو BswM. تقوم بإيقاف تشغيل مجموعات المنافذ بتأخير زمني، وتمرر عمليات التحقق من الاستيقاظ إلى أجهزة الإرسال والاستقبال والمحولات. أهم الشروط الحدية: عند تفعيل اكتشاف الأخطاء، تفترض كل خدمة تقريبًا تنفيذ EthIf_Init مسبق، وإلا سيتم الإبلاغ عن ETHIF_E_UNINIT [SWS_EthIf_00155].

تربط واجهة Ethernet Interface مستخدمي حزمة Ethernet ببرامج التشغيل لوحدات التحكم وأجهزة الإرسال والاستقبال والمحولات. وتصل إلى المحولات عبر برنامج تشغيل أو أكثر من Ethernet Switch Driver [SWS_EthIf_00228]. وفي الاتجاه الأعلى، يتحكم EthSM في أوضاع وحدة التحكم ويتلقى تقارير الأوضاع وحالات الارتباط [SWS_EthIf_00252]. يتلقى BswM حالات الارتباط لمجموعات المنافذ المستقلة [SWS_EthIf_00261].

kontext ul Upper Layer (z. B. EthTSyn, V2xGn) ethif EthIf ul->ethif EthIf_ProvideTxBuffer, EthIf_Transmit ethsm EthSM ethsm->ethif EthIf_SetControllerMode bswm BswM integ Integration Code (EcuM-Kontext) integ->ethif EthIf_CheckWakeup ethif->ul <User>_RxIndication, <UL>_TxConfirmation, <User>_TrcvLinkStateChg ethif->ethsm EthSM_CtrlModeIndication, EthSM_TrcvLinkStateChg ethif->bswm BswM_EthIf_PortGroupLinkStateChg eth Eth (Controller-Treiber) ethif->eth Modus, Puffer, Senden trcv EthTrcv ethif->trcv Modus, Link, Wake-up swt EthSwt ethif->swt EthIfSwitchIdx -> EthSwtIdx weth WEth / WEthTrcv ethif->weth فقط مع EthIfEnableWEthApi det Det ethif->det Entwicklungsfehler idsm IdsM ethif->idsm Security-Events eth->ethif EthIf_RxIndication, EthIf_TxConfirmation, EthIf_CtrlModeIndication trcv->ethif EthIf_TrcvModeIndication

مخطط السياق: EthIf كوسيط بين الطبقة العليا و EthSM و BswM و Integration Code من جهة وبرامج تشغيل Ethernet من جهة أخرى. المصادر: [SWS_EthIf_00228]، [SWS_EthIf_00224]، [SWS_EthIf_00252]، [SWS_EthIf_00261]، EthSwt-SWS ص. 5

يُطلق EthIf_SetControllerMode غير المتزامن بدء الاتصال [SWS_EthIf_00034]. يقوم EthIf في أثناء ذلك بتبديل أجهزة الإرسال والاستقبال ومجموعات المنافذ المشار إليها باستخدام [SWS_EthIf_00266]، [SWS_EthIf_00264]. ويبلغ عن وضع وحدة التحكم الذي تم الوصول إليه عبر EthSM_CtrlModeIndication [SWS_EthIf_00252].

يتم الإرسال في خطوتين باستخدام EthIf_ProvideTxBuffer و EthIf_Transmit [SWS_EthIf_00067]، [SWS_EthIf_00075]. تصل التأكيدات إلى الطبقة العليا عبر <UL>_TxConfirmation؛ وفي وضع الاستقصاء (Polling)، يطلقها EthIf_MainFunctionTx [SWS_EthIf_00255]، [SWS_EthIf_00113]. يوزع EthIf الأطر المستلمة عبر <User>_RxIndication [SWS_EthIf_00104]. ويتجاهل الأطر ذات VLAN غير الصالحة ويحسبها [SWS_EthIf_00317]، [SWS_EthIf_00309].

إرسال إطار مع تأكيدUpper LayerEthIfEthEthIf_ProvideTxBuffer(CtrlIdx, FrameType, Priority, ...)Eth_ProvideTxBuffer(...)BUFREQ_OK, BufIdx, BufPtrBUFREQ_OK, BufIdx, BufPtrملء ذاكرة التخزين المؤقت بالبيانات المفيدةEthIf_Transmit(CtrlIdx, BufIdx, FrameType,TxConfirmation, LenByte, PhysAddrPtr)مع EthIfVlanID: نوع الإطار FrameType 0x8100Eth_Transmit(...)E_OKE_OKaltPolling-ModusEthIf_MainFunctionTx()Eth_TxConfirmation(CtrlIdx)EthIf_TxConfirmation(CtrlIdx, BufIdx, Result)Interrupt-ModusEth_TxIrqHdlr_<CtrlIdx>EthIf_TxConfirmation(CtrlIdx, BufIdx, Result)<UL>_TxConfirmation(CtrlIdx, BufIdx, Result)

مخطط تسلسلي: طلب ذاكرة التخزين المؤقت، والإرسال، والتأكيد في وضع الاستقصاء أو وضع المقاطعة. المصادر: [SWS_EthIf_00067]، [SWS_EthIf_00075]، [SWS_EthIf_00091]، [SWS_EthIf_00113]، EthIf-SWS ص. 87

يحدد EthIf حالات الارتباط دوريًا في EthIf_MainFunctionState [SWS_EthIf_00407]. ويقوم بتجميعها لمجموعات المنافذ [SWS_EthIf_00259]، ويستقصي جودة الإشارة للارتباطات النشطة [SWS_EthIf_00409]. يقوم EthIf بإيقاف تشغيل منافذ المحول لمجموعات المنافذ بتأخير زمني عبر المؤقت EthIfSwitchOffPortTimedelay [SWS_EthIf_00270]. يمرر EthIf_CheckWakeup عمليات التحقق من الاستيقاظ إلى أجهزة الإرسال والاستقبال والمحولات [SWS_EthIf_00245]، [SWS_EthIf_00500].

عند تنشيط DET، تبلغ الخدمات، من بين أمور أخرى، عن فهارس غير صالحة وغياب التهيئة (ETHIF_E_UNINIT) [SWS_EthIf_00017]، [SWS_EthIf_00155]. إذا تم إيقاف تشغيل DET، فإن العديد من الخدمات تعيد E_NOT_OK بدلاً من ذلك [SWS_EthIf_00325]. يمكن إيقاف تشغيل الخدمات الاختيارية مثل وضع الطابع الزمني أو Wireless Ethernet عبر معلمات التكوين [SWS_EthIf_00164]، [SWS_EthIf_00342].

دور EthIf بين برامج تشغيل Ethernet وحزمة الاتصالات

واجهة Ethernet Interface هي طبقة الوساطة المستقلة عن العتاد بين مستخدمي حزمة Ethernet وبرامج التشغيل لوحدات التحكم (Eth) وأجهزة الإرسال والاستقبال (EthTrcv) والمحولات (EthSwt). بالنسبة للمحولات، يستخدم EthIf برنامج تشغيل واحد أو أكثر من برامج Ethernet Switch Driver، والتي تغلف الخصائص الخاصة بكل عتاد [SWS_EthIf_00228]. يوزع EthIf عمليات الوصول عبر EthIfSwitchIdx إلى وحدة EthSwt المختصة مع EthSwtIdx الخاصة بها [SWS_EthIf_00224]. مع EthIfEnableWEthApi، تُضاف برامج تشغيل وحدات التحكم وأجهزة الإرسال والاستقبال اللاسلكية [SWS_EthIf_00340]. توضح الرسوم التوضيحية EthSwt-SWS ص. 5 و Eth-SWS ص. 18 هذا التدرج الطبقي.

في الاتجاه الأعلى، يعمل EthIf مع العديد من الشركاء:

  • يتحكم EthSM في أوضاع وحدة التحكم ويتلقى رسائل الوضع والارتباط [SWS_EthIf_00252]، [SWS_EthIf_00262].
  • يتلقى BswM حالات الارتباط لمجموعات المنافذ التي ليس لها ارتباط بوحدة تحكم [SWS_EthIf_00261].
  • ترسل الطبقات العليا الأطر وتتلقى إشعارات الاستقبال بالإضافة إلى تأكيدات الإرسال [SWS_EthIf_00104]، [SWS_EthIf_00106].
  • يطلق كود الدمج (Integration Code) عمليات فحص الاستيقاظ عبر EthIf_CheckWakeup [SWS_EthIf_00244].

يحدد [SWS_EthIf_00023] الأنواع المستوردة، بما في ذلك Eth_BufIdxType و EcuM_WakeupSourceType. يوضح EthIf-SWS ص. 15 هيكل الملف.

kontext ul Upper Layer (z. B. EthTSyn, V2xGn) ethif EthIf ul->ethif EthIf_ProvideTxBuffer, EthIf_Transmit ethsm EthSM ethsm->ethif EthIf_SetControllerMode bswm BswM integ Integration Code (EcuM-Kontext) integ->ethif EthIf_CheckWakeup ethif->ul <User>_RxIndication, <UL>_TxConfirmation, <User>_TrcvLinkStateChg ethif->ethsm EthSM_CtrlModeIndication, EthSM_TrcvLinkStateChg ethif->bswm BswM_EthIf_PortGroupLinkStateChg eth Eth (Controller-Treiber) ethif->eth Modus, Puffer, Senden trcv EthTrcv ethif->trcv Modus, Link, Wake-up swt EthSwt ethif->swt EthIfSwitchIdx -> EthSwtIdx weth WEth / WEthTrcv ethif->weth فقط مع EthIfEnableWEthApi det Det ethif->det Entwicklungsfehler idsm IdsM ethif->idsm Security-Events eth->ethif EthIf_RxIndication, EthIf_TxConfirmation, EthIf_CtrlModeIndication trcv->ethif EthIf_TrcvModeIndication

مخطط السياق: يربط EthIf بين الطبقة العليا و EthSM و BswM وكود الدمج مع برامج التشغيل لوحدات التحكم وأجهزة الإرسال والاستقبال والمحولات و Wireless Ethernet. المصادر: [SWS_EthIf_00228]، [SWS_EthIf_00224]، [SWS_EthIf_00252]، [SWS_EthIf_00261]، [SWS_EthIf_00244]، [SWS_EthIf_00340]، [SWS_EthIf_00502]، EthSwt-SWS ص. 5

من EthIf_Init إلى EthIfController النشط

EthIf_Init [SWS_EthIf_00024] يتولى بنية Post-Build خاصة بالتطبيق من النوع EthIf_ConfigType [SWS_EthIf_00149]. تتحقق جميع الخدمات تقريبًا، عند تنشيط اكتشاف الأخطاء، مما إذا كانت التهيئة قد تمت. وإلا فإنها تبلغ عن ETHIF_E_UNINIT، على سبيل المثال بعد [SWS_EthIf_00155] أو [SWS_EthIf_00273].

يطلق EthIf_SetControllerMode بدء الاتصال؛ وتعمل الخدمة بشكل غير متزامن [SWS_EthIf_00034]. يقوم EthIf في أثناء ذلك بتبديل العتاد المشار إليه أيضًا:

  • إذا كان EthIfTransceiver المشار إليه مضبوطًا على ETH_MODE_DOWN، تتبع ذلك EthTrcv_SetTransceiverMode واستدعاءات أخرى بترتيب ثابت [SWS_EthIf_00266].
  • في حالة مجموعة منافذ من النوع "control"، يتم تبديل منافذها [SWS_EthIf_00264].
  • في حالة الارتباط المباشر بالمحول، يتم تبديل جميع منافذ المحول (DRAFT) [SWS_EthIf_00478].

يتم التحكم في وحدة التحكم وبقية الأجهزة بشكل مستقل عن بعضها البعض EthIf-SWS ص. 30. وتأتي الاستجابة بشكل غير متزامن: يستدعي برنامج التشغيل EthIf_CtrlModeIndication [SWS_EthIf_00231]، ويقوم EthIf بتمرير الإشعار إلى EthSM_CtrlModeIndication [SWS_EthIf_00252]. وتبلغ أجهزة الإرسال والاستقبال عبر EthIf_TrcvModeIndication [SWS_EthIf_00232].

عند إيقاف التشغيل باستخدام ETH_MODE_DOWN، يقوم EthIf بإيقاف تشغيل أجهزة الإرسال والاستقبال أو منافذ المحول النشطة فقط [SWS_EthIf_00484]، [SWS_EthIf_00485]، [SWS_EthIf_00265]. في المقابل، يمرر EthIf ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST عند كل استدعاء، بغض النظر عن الوضع الحالي [SWS_EthIf_00479]، [SWS_EthIf_00480]، [SWS_EthIf_00481]. القواعد القديمة المتعلقة بإيقاف تشغيل المحول أصبحت OBSOLETE في R20-11 [SWS_EthIf_00256]، [SWS_EthIf_00257].

تغيير وضع EthIfController إلى ETH_MODE_ACTIVEEthSMEthIfEthEthTrcvEthIf_SetControllerMode(CtrlIdx, ETH_MODE_ACTIVE)Eth_SetControllerMode(CtrlIdx, ETH_MODE_ACTIVE)optتمت الإشارة إلى EthIfTransceiver وحالته حاليًا ETH_MODE_DOWNEthTrcv_SetTransceiverMode(TrcvIdx, ETH_MODE_ACTIVE)EthTrcv_TransceiverLinkStateRequest(TrcvIdx, ETHTRCV_LINK_STATE_ACTIVE)E_OKتتم الاستجابة بشكل غير متزامنEthIf_CtrlModeIndication(CtrlIdx, ETH_MODE_ACTIVE)EthSM_CtrlModeIndication(CtrlIdx, ETH_MODE_ACTIVE)EthIf_TrcvModeIndication(TrcvIdx, ETH_MODE_ACTIVE)

مخطط تسلسلي: تغيير الوضع وفقًا لـ ETH_MODE_ACTIVE مع استجابة غير متزامنة من وحدة التحكم وجهاز الإرسال والاستقبال. المصادر: [SWS_EthIf_00034]، [SWS_EthIf_00266]، [SWS_EthIf_00231]، [SWS_EthIf_00252]، [SWS_EthIf_00232]، EthIf-SWS ص. 85

إرسال واستقبال الأطر: الذاكرة المؤقتة، و VLAN، والتأكيدات

يتم الإرسال في خطوتين:

  1. EthIf_ProvideTxBuffer [SWS_EthIf_00067] يعيد فهرس الذاكرة المؤقتة ومؤشر الذاكرة المؤقتة. وبدون تكوين EthIfVlanID، يظل كل من FrameType و Priority غير مستخدمين [SWS_EthIf_00146].
  2. EthIf_Transmit [SWS_EthIf_00075] يبدأ إرسال الذاكرة المؤقتة الممتلئة. في وحدات تحكم VLAN، يمرر EthIf القيمة 0x8100 إلى Eth_Transmit بدلاً من FrameType [SWS_EthIf_00250].

يضيف موضع المستند من R23-11 شرطًا: لا يتم التمرير إلا إذا كان الوضع الأخير المقبول هو ETH_MODE_ACTIVE أو ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST EthIf-SWS ص. 101. لم يتم وصف Silent Communication عبر ETH_MODE_TX_OFFLINE إلا هناك EthIf-SWS ص. 34. وهي لا تنتمي إلى متطلبات R20-11 في الحمولة (Payload).

EthIf_TxConfirmation [SWS_EthIf_00091] يمرر النتيجة عبر <UL>_TxConfirmation إلى الطبقة العليا [SWS_EthIf_00255]، [SWS_EthIf_00106]. في وضع الاستقصاء، يقوم EthIf_MainFunctionTx بإنشاء التأكيدات ويتحقق بالإضافة إلى ذلك من تغييرات حالة أجهزة الإرسال والاستقبال [SWS_EthIf_00113]. في وضع المقاطعة، يستدعي ISR لبرنامج التشغيل مباشرة EthIf-SWS ص. 88. توقيع EthIf_Transmit المستند إلى PDU بدءًا من R24-11 EthIf-SWS ص. 97 لا ينطبق على R20-11.

إرسال إطار مع تأكيدUpper LayerEthIfEthEthIf_ProvideTxBuffer(CtrlIdx, FrameType, Priority, ...)Eth_ProvideTxBuffer(...)BUFREQ_OK, BufIdx, BufPtrBUFREQ_OK, BufIdx, BufPtrملء ذاكرة التخزين المؤقت بالبيانات المفيدةEthIf_Transmit(CtrlIdx, BufIdx, FrameType,TxConfirmation, LenByte, PhysAddrPtr)مع EthIfVlanID: نوع الإطار FrameType 0x8100Eth_Transmit(...)E_OKE_OKaltPolling-ModusEthIf_MainFunctionTx()Eth_TxConfirmation(CtrlIdx)EthIf_TxConfirmation(CtrlIdx, BufIdx, Result)Interrupt-ModusEth_TxIrqHdlr_<CtrlIdx>EthIf_TxConfirmation(CtrlIdx, BufIdx, Result)<UL>_TxConfirmation(CtrlIdx, BufIdx, Result)

مخطط تسلسلي: الإرسال في خطوتين والتأكيد في وضع الاستقصاء أو وضع المقاطعة. المصادر: [SWS_EthIf_00067]، [SWS_EthIf_00075]، [SWS_EthIf_00250]، [SWS_EthIf_00113]، [SWS_EthIf_00091]، [SWS_EthIf_00255]، EthIf-SWS ص. 87، EthIf-SWS ص. 88

يبلغ برنامج التشغيل عن الأطر المستلمة عبر EthIf_RxIndication [SWS_EthIf_00085]. في وضع الاستقصاء، يتحقق EthIf_MainFunctionRx دوريًا من وجود أطر جديدة [SWS_EthIf_00097]. في حالة معالجة الأولوية، يحدث ذلك لكل قائمة انتظار استقبال عبر Eth_Receive مع FifoIdx المناسب [SWS_EthIf_91051]. ويتم التمرير عبر <User>_RxIndication [SWS_EthIf_00104]، ويُفترض أن يكون ذلك إلى المستخدم المعين عبر FrameType. سؤال Q-f3145bbfee9a08d0 (مفتوح)

إذا لم تكن VLAN نشطة، يتجاهل EthIf الإطار ويزيد القيمة المقاسة المقابلة [SWS_EthIf_00317]، وتحديدًا ETHIF_MEAS_DROP_CRTLIDX [SWS_EthIf_00309]. مع EthIfEnableSecurityEventReporting، يبلغ EthIf بالإضافة إلى ذلك عن أحداث الأمان إلى IdsM [SWS_EthIf_00502]، [SWS_EthIf_00503]، EthIf-SWS ص. 225.

rx irq Interrupt-Modus: Eth meldet empfangenen Frame ind EthIf_RxIndication(CtrlIdx, FrameType, IsBroadcast, PhysAddrPtr, DataPtr, LenByte) irq->ind poll Polling-Modus: EthIf_MainFunctionRx ruft Eth_Receive poll->ind vlan VLAN / CtrlIdx صالح؟ ind->vlan dropv إسقاط الإطار، وزيادة ETHIF_MEAS_DROP_CRTLIDX vlan->dropv لا etype Ethertype bekannt? vlan->etype نعم sevv حدث أمني ETHIF_SEV_DROP_INV_VLAN (عند EthIfEnableSecurityEventReporting) dropv->sevv dropt Frame verwerfen etype->dropt لا user <User>_RxIndication(CtrlIdx, FrameType, ...) an zugeordneten Nutzer (Zuordnung per FrameType: Interpretation) etype->user نعم sevt حدث أمني ETHIF_SEV_DROP_UNKNOWN_ETHERTYPE (عند EthIfEnableSecurityEventReporting) dropt->sevt

مخطط النشاط: مسار الاستقبال مع تصفية أطر VLAN غير الصالحة وأنواع Ethertypes غير المعروفة؛ التعيين إلى المستخدم عبر FrameType هو تفسير. المصادر: [SWS_EthIf_00085]، [SWS_EthIf_00097]، [SWS_EthIf_00317]، [SWS_EthIf_00309]، [SWS_EthIf_00503]، [SWS_EthIf_00104]

حالة الارتباط، ومجموعات المنافذ، وجودة الإشارة

تتصرف وحدات التحكم التي ليس لها مرجع جهاز إرسال واستقبال كما لو كان الارتباط ETHTRCV_LINK_STATE_ACTIVE [SWS_EthIf_00229]. إذا تغير الارتباط، يستدعي EthIf لكل EthIfController متأثر <User>_TrcvLinkStateChg [SWS_EthIf_00230]، [SWS_EthIf_00108]. وبدون مجموعة منافذ، يبلغ EthIf عن حالة منفذ المضيف إلى EthSM [SWS_EthIf_00260].

في حالة مجموعات المنافذ، يجمع EthIf الحالة عبر المنافذ. ينطبق ETHTRCV_LINK_STATE_DOWN على سبيل المثال، إذا كان منفذ المضيف أو منفذ الارتباط الصاعد معطلاً (down) [SWS_EthIf_00259]. تذهب النتيجة إلى EthSM إذا كانت المجموعة معينة إلى وحدة تحكم [SWS_EthIf_00262]، وإلا تذهب إلى BswM [SWS_EthIf_00261].

يتم الاستعلام دوريًا في EthIf_MainFunctionState [SWS_EthIf_91104] بالفترة الزمنية EthIfMainFunctionStatePeriod [SWS_EthIf_00407]. إذا كانت هذه المعلمة مفقودة، يتولى EthIf_MainFunctionRx الاستعلام وفقًا للرسم التوضيحي EthIf-SWS ص. 89.

بالنسبة للارتباطات النشطة، يستقصي EthIf بالإضافة إلى ذلك جودة الإشارة، وذلك عبر EthSwt_GetPortSignalQuality [SWS_EthIf_00408] أو EthTrcv_GetPhySignalQuality [SWS_EthIf_00409]. توجد القيمة الحالية وأعلى وأدنى قيمة في EthIf_SignalQualityResultType [SWS_EthIf_91057]. تتم قراءتها عبر [SWS_EthIf_91056]، وإعادة تعيينها عبر [SWS_EthIf_00400] و [SWS_EthIf_00404]. يصف EthIf-SWS ص. 176 قاعدة التحديث.

استعلام دوري عن الرابط (Link) مع مجموعات المنافذEthSMBswMEthIfEthSwtEthTrcvaltEthIfMainFunctionStatePeriod definiertEthIf_MainFunctionState()EthIfMainFunctionStatePeriod غير معرفEthIf_MainFunctionRx()loopجميع منافذ مجموعة المنافذEthSwt_GetLinkState(SwitchIdx, SwitchPortIdx, ...)حالة الرابط (Link) للمنفذEthTrcv_GetLinkState(TrcvIdx, ...)حالة الرابط (Link) لجهاز الإرسال والاستقبالتجميع حالة الرابط (Link) للمجموعةaltتغيير، مجموعة منافذ مع EthIfControllerEthSM_TrcvLinkStateChg(CtrlIdx, TransceiverLinkState)تغيير، مجموعة منافذ دون EthIfControllerBswM_EthIf_PortGroupLinkStateChg(PortGroupIdx, PortGroupState)optLink ETHTRCV_LINK_STATE_ACTIVEEthSwt_GetPortSignalQuality(...)EthTrcv_GetPhySignalQuality(...)EthIf_SignalQualityResultType aktualisieren

مخطط تسلسلي: الاستعلام الدوري عن الارتباط، والتجميع، والإبلاغ إلى EthSM أو BswM، واستقصاء جودة الإشارة. المصادر: [SWS_EthIf_00407]، [SWS_EthIf_00259]، [SWS_EthIf_00262]، [SWS_EthIf_00261]، [SWS_EthIf_00408]، [SWS_EthIf_00409]، EthIf-SWS ص. 91، EthIf-SWS ص. 92

يتم التحكم في مجموعات المنافذ عبر EthIf_SwitchPortGroupIdxType [SWS_EthIf_91101] والخدمة غير المتزامنة EthIf_SwitchPortGroupRequestMode [SWS_EthIf_91102]. عند التنشيط، يضبط EthIf أولاً وضع المنفذ ثم يقدم طلب الارتباط [SWS_EthIf_00272].

يتم إيقاف التشغيل بتأخير زمني. لا يبدأ المؤقت EthIfSwitchOffPortTimedelay [SWS_EthIf_00270] إلا عندما تطلب جميع المجموعات المرجعية ETH_MODE_DOWN. بعد انتهاء وقته، يتبع ذلك EthSwt_PortLinkStateRequest و EthSwt_SetSwitchPortMode، في كل حالة مع DOWN [SWS_EthIf_00271]. يؤثر طلب التنشيط الجديد على المؤقت قيد التشغيل [SWS_EthIf_00483]؛ تفسير: يُرجح إلغاء المؤقت. سؤال Q-be6e407c499a793b (مفتوح)

EthIf_StartAllPorts [SWS_EthIf_91103] يشغل جميع المنافذ المتأثرة [SWS_EthIf_00275]. بعد انتهاء صلاحية EthIfPortStartupActiveTime، يعطل EthIf تلك المنافذ التي لم يتم طلبها بشكل نشط حتى ذلك الحين [SWS_EthIf_00276].

portgroup down ETH_MODE_DOWN active ETH_MODE_ACTIVE down->active EthIf_SwitchPortGroupRequestMode(ETH_MODE_ACTIVE): EthSwt_SetSwitchPortMode(ACTIVE), EthSwt_PortLinkStateRequest(ACTIVE) startup aktiv durch EthIf_StartAllPorts (Frist EthIfPortStartupActiveTime) down->startup EthIf_StartAllPorts delay تأخير إيقاف التشغيل (المؤقت EthIfSwitchOffPortTimedelay) active->delay جميع مجموعات المنافذ المُشيرة تطلب ETH_MODE_DOWN delay->down Timer abgelaufen: EthSwt_PortLinkStateRequest(DOWN), EthSwt_SetSwitchPortMode(DOWN) delay->active erneut ETH_MODE_ACTIVE angefordert (Timerabbruch: Interpretation) startup->down انتهت المهلة، لم يُطلب: EthSwt_PortLinkStateRequest(DOWN)، ... startup->active طُلب مع ETH_MODE_ACTIVE خلال المهلة

مخطط الحالة: دورة حياة منفذ المحول تحت طلبات مجموعات المنافذ، مع تأخير إيقاف التشغيل و StartAllPorts؛ إلغاء المؤقت هو تفسير. المصادر: [SWS_EthIf_00272]، [SWS_EthIf_00270]، [SWS_EthIf_00271]، [SWS_EthIf_00483]، [SWS_EthIf_00275]، [SWS_EthIf_00276]، EthIf-SWS ص. 77

الاستيقاظ والنوم والخدمات الخاصة الممررة

EthIf_CheckWakeup [SWS_EthIf_00244] يعمل بشكل غير متزامن. يستدعي كود الدمج الخدمة، حتى في سياق المقاطعة EthIf-SWS ص. 56. يمرر EthIf إلى EthTrcv_CheckWakeup لجميع أجهزة الإرسال والاستقبال المتأثرة [SWS_EthIf_00245] وإلى EthSwt_SwitchCheckWakeup للمحولات [SWS_EthIf_00500]. عبر EthIfWakeUpSupport يمكن إيقاف تشغيل الخدمة [SWS_EthIf_00248].

بالنسبة لوحدات ECU المضيفة، توصي مواصفة EcuM بالاستقصاء عند الطلب (Polling on demand). ما إذا كان يتم استدعاء EthIf في EcuM_CheckWakeupHook يعتمد على التطبيق EcuM-SWS ص. 192، EcuM-SWS ص. 189.

فحص الإيقاظ لـ ECU مضيفة مزودة بمحول EthernetETH-Hardware (PHY)EcuMIntegration CodeEthIfEthSwtEthTrcvWake-up-InterruptEcuM_CheckWakeupHook(WakeupSource)استدعاء EthIf في هذا الموضعخاص بالتنفيذEthIf_CheckWakeup(WakeupSource)loopجميع محولات Ethernet المعنيةEthSwt_SwitchCheckWakeup(...)loopجميع أجهزة الإرسال والاستقبال المعنية (EthIfTransceiver / مجموعات المنافذ)EthTrcv_CheckWakeup(...)E_OK: تم قبول مهمة الفحصالفحص الفعلي غير متزامنفي EthTrcv_MainFunction

مخطط تسلسلي: التحقق من استيقاظ وحدة ECU مضيفة عبر EthIf إلى برامج تشغيل المحولات وأجهزة الإرسال والاستقبال. المصادر: [SWS_EthIf_00244]، [SWS_EthIf_00245]، [SWS_EthIf_00500]، EcuM-SWS ص. 192، EcuM-SWS ص. 189

بالنسبة للاتجاه المعاكس، توجد متطلبات DRAFT: يؤدي EthIf_SleepIndication [SWS_EthIf_91006] إلى EthSM_SleepIndication [SWS_EthIf_00497]. بمجرد عدم تشغيل أي مؤقتات، يتحقق EthIf مما إذا كان العتاد قد وصل إلى الوضع المطلوب [SWS_EthIf_00498]. في حالة أجهزة الإرسال والاستقبال التي تعمل كتابع سلبي، يتحقق EthIf بالإضافة إلى ذلك من فقدان الارتباط غير المتوقع [SWS_EthIf_00499]. يقدم EthIf_GetPhyWakeupReason أسباب الاستيقاظ عبر EthTrcv_GetBusWuReason [SWS_EthIf_91004]، [SWS_EthIf_00486]. EthIf_SetTransceiverWakeupMode يُعد OBSOLETE [SWS_EthIf_00233].

تقوم العديد من الخدمات بالتمرير فقط:

التكوين ومرجع النسخ (Instance)

تتم عنونة الكيانات عبر فهارس في سياق EthIf: CtrlIdx لـ EthIfController، و TrcvIdx لأجهزة الإرسال والاستقبال، و SwitchIdx للمحولات. يمكن لـ EthIfController الإشارة إلى جهاز إرسال واستقبال، أو محول، أو مجموعة منافذ [SWS_EthIf_00266]، [SWS_EthIf_00478]، [SWS_EthIf_00264]. عبر EthIfVlanID، يمكنه أيضًا تمثيل VLAN [SWS_EthIf_00250]. تجعل EthIf_GetVlanId [SWS_EthIf_00301] و EthIf_GetCtrlIdxList [SWS_EthIf_00298] هذه النسخ مرئية أثناء وقت التشغيل. يتم تمكين أو تعطيل الخدمات الاختيارية قبل التحويل البرمجي:

المعلماتيبدلالمرجع
EthIfGlobalTimeSupportخدمات الطابع الزمني[SWS_EthIf_00164], [SWS_EthIf_00170]
EthIfWakeUpSupportEthIf_CheckWakeup[SWS_EthIf_00248]
EthIfEnableWEthApiالخدمات اللاسلكية[SWS_EthIf_00342]
EthIfSwitchManagementSupportإدارة المحول[SWS_EthIf_00279]
EthIfGetPortMacAddrApi, EthIfGetArlTableالبحث عن عنوان MAC والمنفذ، جدول ARL[SWS_EthIf_00192], [SWS_EthIf_00198]
EthIfStoreConfigurationApi, EthIfResetConfigurationApiحفظ أو إعادة تعيين جداول MAC/المنفذ المستفادة[SWS_EthIf_00216], [SWS_EthIf_00221]
EthIfVerifyConfigApiفحص تكوين المحول[SWS_EthIf_00305]
EthIfGetAndResetMeasurementDataApiبيانات القياس[SWS_EthIf_00316]

يتحكم المعلم EthIfEnableRxInterrupt EthIf-SWS ص. 174 في الاستقبال عبر المقاطعة أو الاستقصاء، وفقًا لموضع المستند من R24-11.

التصرف في حالة الخطأ

يبلغ EthIf عن أخطاء التطوير إلى DET. يعرّف [SWS_EthIf_00017] من بين أمور أخرى ETHIF_E_INV_CTRL_IDX (0x01) و ETHIF_E_INV_TRCV_IDX (0x02). تستخدم متطلبات الخدمات الفردية بالإضافة إلى ذلك:

إذا تم إيقاف تشغيل DET، فإن العديد من الخدمات تعيد E_NOT_OK بدلاً من ذلك [SWS_EthIf_00325]، [SWS_EthIf_00326]. وبشكل مختلف، يذكر [SWS_EthIf_00319] الرمز ETHIF_E_NOTINIT.

تصبح أخطاء وقت التشغيل مرئية من خلال القيم المرجعة:

  • EthIf_Transmit يعيد E_NOT_OK إذا فشل الإرسال [SWS_EthIf_00075].
  • EthIf_ProvideTxBuffer يعيد BufReq_ReturnType [SWS_EthIf_00067].
  • يمرر EthIf_TxConfirmation نتيجة الإرسال السلبية دون تغيير إلى الطبقة العليا [SWS_EthIf_00255].
  • EthIf_GetPortMacAddr يبلغ عن E_NOT_OK إذا لم يتطابق أي منفذ أو تطابقت منافذ متعددة [SWS_EthIf_00191].
  • EthIf_GetAndResetMeasurementData يبلغ عن E_NOT_OK في حالة الفهرس غير المدعوم [SWS_EthIf_00310]. لا تتجاوز العدادات سعتها [SWS_EthIf_00313]، ويُستخدم ETHIF_MEAS_ALL لإعادة التعيين فقط [SWS_EthIf_00312]، EthIf-SWS ص. 65.

على مستوى الشبكة، يحسب EthIf الأطر المهملة ويبلغ عنها اختياريًا كحدث أمني [SWS_EthIf_00309]، [SWS_EthIf_00503]. ينشر EthIf فقدان الارتباط إلى المستخدمين أو إلى EthSM أو BswM [SWS_EthIf_00230]، [SWS_EthIf_00262]، [SWS_EthIf_00261]. في حالة أجهزة الإرسال والاستقبال التي تعمل كتابع سلبي، يكتشف EthIf بالإضافة إلى ذلك انقطاع الارتباط (Link-Down) غير المتوقع [SWS_EthIf_00499].

أدلة تفصيلية إضافية

دليل وحدات تم إنشاؤه بواسطة الذكاء الاصطناعي بناءً على الأدلة الواردة في الحمولة (Payload). يُعد مواصفة AUTOSAR لـ Ethernet Interface R20-11 وحدها المعيارية الإلزامية. مواضع الوثائق من إصدارات أخرى موضحة على هذا النحو.

Ethernet Interface (EthIf)

Abstracts Ethernet controller and transceiver hardware for upper protocol layers.

Funktionen — Übersicht

Typen — Übersicht

Funktionen & Typen — Detailansicht

دالة EthIf_Init [SWS_EthIf_00024] 📄 PDF

void EthIf_Init (const EthIf_ConfigType* CfgPtr);

Initializes the Ethernet Interface

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 5453d77780ab المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام والدلالات

تهيئ الدالة EthIf_Init وحدة واجهة Ethernet ([SWS_EthIf_00024]). تُنفّذ بشكل متزامن، وهي غير قابلة لإعادة الدخول (Non Reentrant) ومتوفرة عبر ملف الرأس EthIf.h بمعرّف الخدمة 0x01. كمعامل تمرير وحيد، تتوقع الدالة المؤشر CfgPtr، الذي يشير إلى هيكل تكوين خاص بالتنفيذ من النوع EthIf_ConfigType. لا توجد معاملات Inout أو Out، ولا تمتلك الدالة أي قيمة مرجعة ([SWS_EthIf_00024]).

التزامن وسياق الاستدعاء

نظراً لأن EthIf_Init غير قابلة لإعادة الدخول، فلا يجوز إجراء أي استدعاء متزامن أو متداخل [SWS_EthIf_00024]. ولأن سياق الاستدعاء المحدد لم يتم تفصيله في البيانات المفيدة (Payload)، فمن المرجح عادةً أن يحدث الاستدعاء مرة واحدة أثناء تسلسل تهيئة وحدة التحكم الإلكترونية (ECU) قبل استخدام خدمات Ethernet الأخرى. سؤال Q-07e92f9f3c15ea5b (مفتوح)

شروط الترتيب والتفاعل

يمثل استدعاء EthIf_Init شرطاً إلزامياً لاستخدام جميع الدوال الأخرى للوحدة. إذا كان اكتشاف أخطاء التطوير (Development Error Detection) مفعّلاً، تتحقق العديد من خدمات واجهة Ethernet قبل تنفيذها مما إذا كان قد تم استدعاء EthIf_Init مسبقاً:

تم إنشاء ملاحظة الاستخدام هذه آليًا وتستند إلى مواصفة 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: ae12ff5b506f المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تمكّن الدالة EthIf_SetControllerMode أو تعطل وحدة تحكم Ethernet المحددة عبر CtrlIdx في سياق واجهة Ethernet [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].

التفاعل وإعادة التوجيه

إذا تم استدعاء EthIf_SetControllerMode مع ETH_MODE_ACTIVE لوحدة تحكم تشير إلى EthIfSwitchPortGroup من النوع «control»، فإن EthIf يعيد توجيه الاستدعاء إلى جميع منافذ المجموعة، بشرط أن يُطلب هذا الوضع للمنفذ لأول مرة وأن تكون حالته ETH_MODE_DOWN. وفي هذا الإطار، يُنفّذ بالتتابع EthSwt_SetSwitchPortMode مع ETH_MODE_ACTIVE وEthSwt_PortLinkStateRequest مع ETHTRCV_LINK_STATE_ACTIVE [SWS_EthIf_00264].

عند طلب ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST، يعيد EthIf توجيه الاستدعاءات بغض النظر عن الوضع الحالي على النحو التالي:

  • عند الإشارة إلى EthIfTransceiver: استدعاء EthTrcv_SetTransceiverMode مع ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST ثم EthTrcv_TransceiverLinkStateRequest مع ETHTRCV_LINK_STATE_ACTIVE، في حال كانت الحالة الحالية هي ETHTRCV_LINK_STATE_DOWN [SWS_EthIf_00479].
  • عند الإشارة إلى EthIfSwitch أو إلى EthIfSwitchPortGroup من النوع «control»: استدعاء EthSwt_SetSwitchPortMode مع ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST ثم EthSwt_PortLinkStateRequest مع ETHTRCV_LINK_STATE_ACTIVE، في حال كانت الحالة الحالية هي ETHTRCV_LINK_STATE_DOWN [SWS_EthIf_00480]، [SWS_EthIf_00481].

القيود

الدالة غير قابلة لإعادة الدخول (Non Reentrant) ومتوفرة عبر EthIf.h [SWS_EthIf_00034].

تم إنشاء ملاحظة الاستخدام هذه تلقائيًا استنادًا إلى مواصفات AUTOSAR CP R20-11.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

دالة 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: d9ee9c3c6e19 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة المتزامنة وغير القابلة لإعادة الدخول EthIf_SetTransceiverWakeupMode (معرّف الخدمة 0x2e) لضبط وضع الاستيقاظ لجهاز إرسال واستقبال تم عنونته عبر TrcvIdx في Ethernet Interface أو لإعادة ضبط سبب استيقاظه [SWS_EthIf_00233]. تم الإعلان عن الدالة في ملف الرأس EthIf.h وتم تمييزها بأنها مهملة (obsolete) في الإصدار AUTOSAR CP R20-11 [SWS_EthIf_00233].

يتم التحكم عبر معامل التمرير TrcvWakeupMode [SWS_EthIf_00233]:

  • ETHTRCV_WUM_ENABLE: يُفعّل إيقاظ جهاز الإرسال والاستقبال (transceiver) [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]. نظرًا لأن الواجهة معرّفة بأنها غير قابلة لإعادة الدخول (non-reentrant)، فإن الاستدعاءات المتزامنة غير مسموح بها [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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 99f093847096 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تطلب الدالة EthIf_CheckWakeup من عتاد Ethernet المعني فحص تنبيه مُشار إليه [SWS_EthIf_00244]. ويُستخدم هذا، على سبيل المثال، لعتاد Ethernet المتوافق مع مواصفة OPEN Alliance TC10 [SWS_EthIf_00244]. ويتم الاستدعاء بشكل غير متزامن وقابل لإعادة الدخول بواسطة كود التكامل، إما في سياق مقاطعة أو على مستوى المهمة [SWS_EthIf_00244].

تُستخدم WakeupSource من النوع EcuM_WakeupSourceType كمعلمة إدخال، وتحدد الجهاز المصدر المُطلِق (جهاز إرسال واستقبال Ethernet أو مبدل Ethernet) [SWS_EthIf_00244]. وتكون قيمة الإرجاع هي E_OK في حال قبول طلب الفحص من العتاد، وإلا تكون E_NOT_OK عند رفض الطلب [SWS_EthIf_00244]. وتُمرر الوحدة النمطية الاستدعاء داخليًا إلى برامج التشغيل التابعة:

  • لكل أجهزة إرسال واستقبال Ethernet المعنية (المشار إليها عبر EthIfTransceiver أو EthIfSwitchPortGroups)، يتم استدعاء EthTrcv_CheckWakeup لبرنامج تشغيل جهاز الإرسال والاستقبال المعني [SWS_EthIf_00245].
  • لكل مبدلات Ethernet المعنية (المشار إليها عبر EthIfSwitch)، يتم استدعاء EthSwt_SwitchCheckWakeup لبرنامج تشغيل المبدل المقابل [SWS_EthIf_00500].

يمكن تفعيل وتعطيل توفر EthIf_CheckWakeup في وقت ما قبل التجميع عبر معلمة التهيئة EthIfWakeUpSupport [SWS_EthIf_00248]. ويتم توفير API عبر ملف الترويسة EthIf.h [SWS_EthIf_00244].

تم إنشاء ملاحظة الاستخدام هذه تلقائيًا بناءً على مواصفة AUTOSAR R20-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

دالة 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 0059e8b2ee6e المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة المتزامنة EthIf_UpdatePhysAddrFilter ([SWS_EthIf_00139]) لتحديث مرشح العناوين لوحدة تحكم Ethernet المحددة عبر CtrlIdx. ويتم عبر المعلمة Action (من النوع Eth_FilterActionType) إضافة عنوان فيزيائي إلى المرشح أو إزالته منه.

بالنسبة للتهيئة، تتوقع PhysAddrPtr مؤشرًا إلى عنوان MAC الفيزيائي بترتيب بايتات الشبكة، والذي يمثل عنوان وجهة البث المتعدد لحزمة Ethernet من الطبقة 2 [SWS_EthIf_00139]. وعلى الرغم من أن الوصف النصي للدالة يتحدث عن عنوان مصدر، إلا أنه يُرجح أن يكون ذلك سهوًا تحريريًا، نظرًا لأن مواصفة المعلمة تحدد عنوان وجهة البث المتعدد بشكل ملزم. سؤال Q-312e20e5eadda94a (مفتوح)

فيما يتعلق بسير العمل والقيود، تسري التوجيهات التالية [SWS_EthIf_00139]:

  • القيم المعادة: تُرجع الدالة E_OK إذا تم تغيير تهيئة المرشح بنجاح، أو E_NOT_OK إذا فشل التغيير. لم يتم تحديد رموز خطأ خاصة بـ DET أو DEM في المصادر.
  • دعم العتاد: إذا كانت وحدة تحكم Ethernet الأساسية غير قادرة عتاديًا على إجراء التصفية، فيجب على البرمجيات تولي مهمة التصفية هذه.
  • التزامن: الاستدعاء غير قابل لإعادة الدخول لنفس فهرس وحدة التحكم (CtrlIdx)، ولكنه قد يُنفذ بالتزامن لوحدات تحكم مختلفة.

تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي استنادًا إلى مواصفة R20-11.

دالة 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_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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 31fa677de79c المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام وسياق الاستدعاء

تُستخدم الدالة EthIf_StoreConfiguration لطلب التخزين الدائم لجداول MAC/Port التي تم تعلمها لمبدل Ethernet [SWS_EthIf_00214]. يُذكر Complex Device Driver (CDD) على سبيل المثال كجهة استدعاء نموذجية [SWS_EthIf_00214]. يمكن الوصول إلى الواجهة عبر ملف الرأس EthIf.h وتمتلك معرّف الخدمة 0x2c [SWS_EthIf_00214].

يتم عبر معلمة الإدخال SwitchIdx تمرير فهرس المبدل الهدف في سياق مشغل مبدل Ethernet [SWS_EthIf_00214]. وكقيمة معادة، تُرجع الدالة الحالة Std_ReturnType: تشير القيمة E_OK إلى أنه تم قبول طلب التخزين، بينما تشير E_NOT_OK إلى عدم القبول [SWS_EthIf_00214]. ونظرًا لأن المواصفة تصنف التنفيذ على أنه متزامن/غير متزامن، فمن المرجح أن يتم استلام الطلب بشكل متزامن، بينما يُفترض أن تتم عملية الحفظ الدائم الفعلية بشكل غير متزامن في الوحدات اللاحقة. سؤال 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 46cb0df40dd4 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام وسياق الاستدعاء

تُستخدم الدالة EthIf_ResetConfiguration لطلب إعادة التعيين الدائمة لجداول MAC وPort التي تم تعلمها ديناميكيًا لمبدل Ethernet [SWS_EthIf_00219]. وتظل الإدخالات المهيأة استاتيكيًا دون تغيير في التهيئة [SWS_EthIf_00219]. يمكن لـ Complex Device Driver (CDD) على سبيل المثال أن يعمل كجهة استدعاء لهذه الواجهة [SWS_EthIf_00219].

يتم عبر معلمة التمرير SwitchIdx تحديد فهرس المبدل المعني في سياق مشغل مبدل Ethernet [SWS_EthIf_00219]. وفيما يتعلق بدلالات التنفيذ، تم توضيح العملية على أنها متزامنة/غير متزامنة [SWS_EthIf_00219]؛ ومن المحتمل أن يعني هذا أن استلام الطلب يتم تأكيده بشكل متزامن، بينما تتم إعادة تعيين جداول العتاد بشكل غير متزامن. سؤال Q-9e7f89ec9e809fd0 (مفتوح)

قيم الإرجاع ومعالجة الأخطاء

تُرجع الدالة حالة من النوع Std_ReturnType كقيمة إرجاع [SWS_EthIf_00219]:

  • E_OK: تم قبول طلب إعادة التعيين الدائمة لجدول MAC/Port بنجاح [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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 3c09f202ad0f المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة المتزامنة 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 93249af97580 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تطلب الدالة غير المتزامنة 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): يُمرر الاستدعاء بشكل إلزامي بترتيب محدد لجميع منافذ المجموعة بغض النظر عن نمط المنفذ الحالي: أولاً، يُستدعى EthSwt_SetSwitchPortMode مع ETH_MODE_ACTIVE_WITH_WAKEUP_REQUEST، يليه EthSwt_PortLinkStateRequest مع ETHTRCV_LINK_STATE_ACTIVE، إذا كانت حالة الرابط الحالية هي 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 482f0b4972cd المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة EthIf_StartAllPorts لطلب ضبط جميع منافذ مبدل Ethernet المهيأة والمعنية على الحالة ETH_MODE_ACTIVE ([SWS_EthIf_91103]). ويتم الاستدعاء بدون معلمات، وله دلالات غير متزامنة، وهو محدد بأنه قابل لإعادة الدخول ([SWS_EthIf_91103]). وكقيمة إرجاع، تشير E_OK إلى قبول الطلب، بينما تشير E_NOT_OK إلى رفضه ([SWS_EthIf_91103]).

بعد استدعاء EthIf_StartAllPorts، تُمرر EthIf أوامر التحكم إلى جميع المنافذ المعنية لمبدلات Ethernet (EthSwtPorts) بترتيب محدد بدقة ([SWS_EthIf_00275]):

  • أولاً، يُستدعى EthSwt_SetSwitchPortMode مع ETH_MODE_ACTIVE، بشرط أن يكون النمط الحالي هو ETH_MODE_DOWN ([SWS_EthIf_00275]).
  • بعد ذلك، يتم استدعاء EthSwt_PortLinkStateRequest مع ETHTRCV_LINK_STATE_ACTIVE، إذا كانت حالة الرابط الحالية هي ETHTRCV_LINK_STATE_DOWN، ويتم بدء تشغيل مؤقت بالمدة الزمنية EthIfPortStartupActiveTime لجميع هذه المنافذ ([SWS_EthIf_00275]).

إذا لم يُطلب منفذ تم تفعيله بهذه الطريقة بشكل منتظم مع ETH_MODE_ACTIVE خلال الفترة الزمنية EthIfPortStartupActiveTime، فإن EthIf تُعطل هذا المنفذ تلقائيًا مرة أخرى ([SWS_EthIf_00276]). ويحدث إلغاء التفعيل بشكل إلزامي بترتيب عكسي:

  • أولاً، يُستدعى EthSwt_PortLinkStateRequest مع ETHTRCV_LINK_STATE_DOWN ([SWS_EthIf_00276]).
  • بعد ذلك، يُستدعى EthSwt_SetSwitchPortMode مع ETH_MODE_DOWN ([SWS_EthIf_00276]).

تستند ملاحظة الاستخدام هذه إلى مواصفات منصة AUTOSAR Classic الإصدار 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_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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 97b7a2a9a3c5 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُفعّل الدالة EthIf_SwitchEnableTimeStamping ([SWS_EthIf_91007]) تسجيل الأختام الزمنية للخروج لكائن رسالة محدد على مستوى المبدل. وتتم عنونة كائن الإرسال المقترن عبر فهرس وحدة التحكم CtrlIdx وفهرس المخزن المؤقت BufIdx.

الاستدعاء والمعاملات

يتم الاستدعاء بشكل متزامن ([SWS_EthIf_91007]). وتتوقع الدالة كمعاملات إدخال فهرس وحدة التحكم CtrlIdx ضمن سياق EthIf بالإضافة إلى BufIdx لمخزن الرسائل المؤقت الذي يتوقع التطبيق عنده الختم الزمني. وتُتاح معلومات الإدارة المقترنة ([SWS_EthIf_91007]) عبر معامل الإخراج MgmtInfo من النوع EthSwt_MgmtInfoType*.

القيم المرجعة والسلوك

تشير الدالة إلى النتيجة عبر قيمة معادة من النوع Std_ReturnType ([SWS_EthIf_91007]):

القيود والتزامن

تم تحديد الواجهة على أنها غير قابلة لإعادة الدخول (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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 775ea0d621ed المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم دالة الواجهة المتزامنة EthIf_VerifyConfig للتحقق من تهيئة المبدل وتُمرر الاستدعاء مباشرة إلى EthSwt_VerifyConfig [SWS_EthIf_91012]. ويتم إجراء التحقق الفعلي بواسطة مشغل مبدل Ethernet اعتمادًا على بنية العتاد المعنية وقدرات العتاد ودقة الفحص المستهدفة [SWS_EthIf_91012].

الاستخدام والمعلمات

تتوفر الدالة عبر ملف الرأس EthIf.h بمعرّف الخدمة 0x40 وتتوقع معلمتين [SWS_EthIf_91012]:

  • SwitchIdx (in): فهرس المبدّل في سياق مشغّل مبدّل Ethernet.
  • Result (out): مؤشر إلى قيمة منطقية (Boolean) تستقبل نتيجة التحقق. تشير 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 84d8304b8c11 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُقدَّم الدالة المتزامنة EthIf_SetForwardingMode عبر ملف الرأس EthIf.h وتُستخدم للتحكم في توجيه الأطر (Frame Forwarding) في مبدل Ethernet [SWS_EthIf_91013]. وهي تتحقق من تهيئة المبدل الحالية وتجري إعادة تهيئة للمبدل في حال تم اكتشاف عدم صلاحيتها [SWS_EthIf_91013].

المعلمات وقيم الإرجاع

عند الاستدعاء (معرّف الخدمة 0x41)، يتم تمرير معلمات الإدخال التالية [SWS_EthIf_91013]:

  • SwitchIdx: فهرس المبدل المعني في سياق مشغل مبدل Ethernet [SWS_EthIf_91013].
  • mode: مفتاح منطقي (Boolean) لتفعيل (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]. لذا يجب على جهات الاستدعاء التأكد من تنفيذ الاستدعاءات لنفس سياق المبدل أو لسياقات متوازية بشكل متسلسل وعدم حدوث استدعاءات متنافسة. لم يتم تحديد رموز خطأ خاصة بـ 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: b5e0adba4624 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة EthIf_ClearTrcvSignalQuality للحذف المتزامن لقيم جودة الإشارة المخزنة لاتصال Ethernet لجهاز إرسال واستقبال معين [SWS_EthIf_91059]. وللقيام بذلك، يمرر المتصل عبر المعلمة 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]. لذلك، لا يجوز إجراء استدعاءات متعددة لنفس جهاز الإرسال والاستقبال بشكل متزامن من سياقات متزامنة ويجب تأمينها وفقاً لذلك.

في التفاعل بين الوحدات، يحذف الاستدعاء بشكل مستهدف قيم جودة الإشارة المودعة من النوع EthIf_SignalQualityResultType لـ EthIfTransceiver المعنون عبر TrcvIdx [SWS_EthIf_00400]. يتم توفير إعلان الواجهة المتزامنة مع معرّف الخدمة 0x19 عبر ملف الرأس EthIf.h [SWS_EthIf_91059].

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR R20-11.

دليل المنفِّذ قيد الإعداد (التعقيد 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 821340633a61 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستخدم الدالة المتزامنة 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]. لذلك، يجب على المتصلين التأكد من تجنب الاستدعاءات المتزامنة لنفس المنفذ أو حمايتها بواسطة آليات مزامنة مناسبة.

تم إنشاء هذا النص بواسطة ذكاء اصطناعي وهو بمثابة وثائق توجيهية.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

دالة EthIf_SetPhyTestMode [SWS_EthIf_91016] 📄 PDF

Std_ReturnType EthIf_SetPhyTestMode (uint8 TrcvIdx, EthTrcv_PhyTestModeType Mode);

Activates a given test mode.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 64928adfaeea المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم دالة الواجهة المتزامنة EthIf_SetPhyTestMode لتفعيل وضع اختبار محدد مسبقًا في جهاز إرسال واستقبال Ethernet [SWS_EthIf_91016]. الخدمة مصرّح عنها في ملف الرأس EthIf.h ويمكن التعرف عليها عبر معرّف الخدمة الست عشري 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].

فيما يتعلق بالتزامن، فإن EthIf_SetPhyTestMode محددة بأنها قابلة لإعادة الدخول لفهارس أجهزة الإرسال والاستقبال المختلفة (TrcvIdx) [SWS_EthIf_91016]. أما لنفس فهرس جهاز الإرسال والاستقبال، فالتنفيذ صراحةً غير قابل لإعادة الدخول [SWS_EthIf_91016]. لذا يجب على جهات الاستدعاء التأكد من تجنب الاستدعاءات المتنافسة لنفس نسخة جهاز الإرسال والاستقبال وتنسيقها بشكل متسلسل بدلاً من ذلك.

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على المواصفات.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

دالة EthIf_SetPhyLoopbackMode [SWS_EthIf_91018] 📄 PDF

Std_ReturnType EthIf_SetPhyLoopbackMode (uint8 TrcvIdx, EthTrcv_PhyLoopbackModeType Mode);

Activates a given loopback mode.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: f13ccd8e218e المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستخدم الدالة المتزامنة EthIf_SetPhyLoopbackMode لتفعيل وضع حلقة راجعة (Loopback) محدد في جهاز إرسال واستقبال 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]. تفسير: من المحتمل أن تُعيد الدالة توجيه الاستدعاء بشكل متزامن إلى مشغل جهاز إرسال واستقبال Ethernet المسؤول عن TrcvIdx. سؤال Q-c4736bbfd250cca0 (مفتوح)

معالجة الأخطاء

لم يتم تحديد رموز خطأ خاصة، مثل رسائل DET أو أحداث DEM، في مقتطف المواصفة. وإذا فشل قبول الطلب، يتم إبلاغ جهة الاستدعاء بذلك على الفور عبر القيمة المعادة E_NOT_OK [SWS_EthIf_91018]. ويجب على جهات الاستدعاء فحص هذه القيمة المعادة قبل مواصلة إجراءات الاختبار أو التشخيص اللاحقة.

التزامن والقيود

الدالة قابلة لإعادة الدخول لفهارس أجهزة الإرسال والاستقبال المختلفة (TrcvIdx)، ولكنها صراحةً غير قابلة لإعادة الدخول لنفس فهرس جهاز الإرسال والاستقبال [SWS_EthIf_91018]. لذا يجب على جهات الاستدعاء ضمان تجنب الاستدعاءات المتزامنة لنفس نسخة جهاز الإرسال والاستقبال أو تأمينها عبر آليات مزامنة مناسبة [SWS_EthIf_91018].

تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويستند إلى مواصفة 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 938ed4c4359d المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم دالة الواجهة المتزامنة EthIf_SetPhyTxMode لتفعيل وضع إرسال معيّن لجهاز إرسال واستقبال Ethernet [SWS_EthIf_91005]. يتم التصريح عن الدالة في ملف الرأس EthIf.h تحت معرف الخدمة (Service 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 قابلة لإعادة الدخول (reentrant) لفهارس أجهزة إرسال واستقبال مختلفة (TrcvIdx) [SWS_EthIf_91005]. ومع ذلك، إذا تم إصدار استدعاءات لنفس فهرس جهاز الإرسال والاستقبال، فإن الدالة تُعرّف بأنها غير قابلة لإعادة الدخول وتتطلب استدعاءً متزامنًا أو تسلسليًا [SWS_EthIf_91005].

كقيد شكلي، تجدر الإشارة إلى أن عنصر الواجهة هذا مميز في مواصفات AUTOSAR CP R20-11 بالحالة draft [SWS_EthIf_91005].

تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي بناءً على مواصفات AUTOSAR CP R20-11.

دليل المنفِّذ قيد الإعداد (التعقيد 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_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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 3376c496dada المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تتيح الدالة المتزامنة والقابلة لإعادة الدخول EthIf_ProvideTxBuffer (معرّف الخدمة 0x09) الوصول إلى ذاكرة تخزين مؤقت للإرسال لوحدة تحكم Ethernet المحددة عبر CtrlIdx، وتتوفر عبر ملف الرأس EthIf.h [SWS_EthIf_00067].

لطلب ذاكرة التخزين المؤقت، يمرر المتصل فهرس وحدة التحكم (CtrlIdx)، ونوع إطار Ethernet (FrameType)، بالإضافة إلى الأولوية (Priority) لحقل PCP المكون من 3 بتات لعلامة VLAN [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.

دالة 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: c6420d48f21a المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تطلق الدالة المتزامنة EthIf_Transmit عملية إرسال مخزن مؤقت للإرسال تم توفيره وتعبئته مسبقاً عبر واجهة Ethernet [SWS_EthIf_00075].

الاستخدام والمعلمات

يتم الاستدعاء عبر الواجهة المصرح عنها في EthIf.h باستخدام معاملات التمرير التالية [SWS_EthIf_00075]:

  • CtrlIdx: فهرس وحدة تحكم Ethernet في سياق الوحدة 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_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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 195c682ee5fe المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة EthIf_SwitchPortGetLinkState وفقاً لـ [SWS_EthIf_91109] للاستعلام عن حالة الاتصال الحالية لمنفذ محول معين. يتم تمرير فهرس المحول SwitchIdx في سياق مشغل محول Ethernet وفهرس المنفذ 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])، ولهذا السبب يجب استبعاد الاستدعاءات المتزامنة في نفس السياق. الإعلان متاح عبر ملف الرأس EthIf.h مع معرّف الخدمة 0x4b.

تم إنشاء هذا النص بواسطة ذكاء اصطناعي؛ المرجع المعتمد هو مواصفة 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 9458911dc392 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستخدم الدالة المتزامنة EthIf_TransceiverGetLinkState للاستعلام عن حالة الاتصال الحالية (Link State) لجهاز إرسال واستقبال Ethernet معنون عبر TrcvIdx وفقاً لـ [SWS_EthIf_91110]. يتم توفير إعلان الواجهة عبر ملف الرأس 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].

معالجة الأخطاء والشروط الحدية

إذا فشل الاستعلام، فإن الخدمة ذات معرّف الخدمة 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 420db0a0bb52 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة EthIf_SwitchPortGetBaudRate للاستعلام عن سرعة النقل الحالية لمنفذ محول Ethernet معين وفقاً لـ [SWS_EthIf_91111]. عند الاستدعاء، يتم تمرير فهرس المحول (SwitchIdx) وفهرس المنفذ في المحول المعنون (SwitchPortIdx). يتم توفير نتيجة الاستعلام عبر المؤشر BaudRatePtr من النوع EthTrcv_BaudRateType*، والذي يمكنه تمثيل سرعات مثل 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 792ee7d557d1 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة المتزامنة EthIf_TransceiverGetBaudRate ذات معرّف الخدمة 0x4e لقراءة معدل النقل الحالي لجهاز إرسال واستقبال Ethernet مفهرس [SWS_EthIf_91112]. وهي جزء من الوحدة EthIf ويتم توفيرها عبر ملف الرأس EthIf.h [SWS_EthIf_91112].

تحدد معلمة الإدخال TrcvIdx من النوع uint8 جهاز الإرسال والاستقبال في سياق مشغل جهاز إرسال واستقبال Ethernet [SWS_EthIf_91112]. لا توجد معلمات إدخال/إخراج [SWS_EthIf_91112]. يتم إرجاع نتيجة الاستعلام عبر معلمة الإخراج BaudRatePtr [SWS_EthIf_91112]. القيم الصالحة من النوع Eth_Trcv_BaudRateType هي ETHTRCV_BAUD_RATE_10MBIT (10 ميجابت/ثانية)، وETHTRCV_BAUD_RATE_100MBIT (100 ميجابت/ثانية)، وETHTRCV_BAUD_RATE_1000MBIT (1000 ميجابت/ثانية)، وETHTRCV_BAUD_RATE_2500MBIT (2500 ميجابت/ثانية) [SWS_EthIf_91112].

تُرجع الدالة حالة من النوع Std_ReturnType: عند الاستدعاء الناجح، يتم تمرير E_OK [SWS_EthIf_91112]. إذا تعذر تهيئة جهاز الإرسال والاستقبال، تفشل الخدمة وتبلّغ عن E_NOT_OK [SWS_EthIf_91112].

فيما يتعلق بسياق الاستدعاء والتزامن، تم تعريف EthIf_TransceiverGetBaudRate كواجهة متزامنة وغير قابلة لإعادة الدخول (Non Reentrant) [SWS_EthIf_91112]. يجب على الطبقات المستدعية التأكد من تجنب الاستدعاءات المتنافسة لهذه الخدمة أو تسلسلها على مستوى المتصل [SWS_EthIf_91112].

تم توليد هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR CP R20-11.

دليل المنفِّذ قيد الإعداد (التعقيد 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: f64160e278b6 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة EthIf_SwitchPortGetDuplexMode للاستعلام عن وضع الإرسال المزدوج الحالي لمنفذ مفهرس في محول Ethernet [SWS_EthIf_91113]. تقوم بإعادة توجيه الاستدعاء إلى الدالة EthSwt_GetDuplexMode الخاصة بمشغل محول Ethernet المخصص عبر SwitchIdx [SWS_EthIf_00428].

المعلمات والواجهة

  • SwitchIdx: فهرس محول Ethernet في سياق المشغل [SWS_EthIf_91113].
  • 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 003ecb88f2c1 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تحدد الدالة المتزامنة EthIf_TransceiverGetDuplexMode وضع الإرسال المزدوج الحالي لجهاز إرسال واستقبال Ethernet مفهرس وفقاً لـ [SWS_EthIf_91114].

الاستخدام والمعلمات

يتم الاستدعاء بشكل متزامن ومحدد كغير قابل لإعادة الدخول (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].

القيود والتزامن

نظراً لأن الواجهة غير قابلة لإعادة الدخول، فلا يجوز إجراء استدعاءات متوازية لنفس مثيلات أجهزة الإرسال والاستقبال أو لمثيلات مختلفة دون مزامنة خارجية. الإعلان متاح عبر ملف الرأس 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 7e473c4bc2cc المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة المتزامنة EthIf_SwitchPortGetCounterValues لقراءة قيم العدادات (Drop Counter) لمنفذ مبدل Ethernet محدد وفقًا لـ [SWS_EthIf_91115]. وتستقبل الدالة، المتوفرة عبر ملف الرأس EthIf.h، فهرس المبدل SwitchIdx بالإضافة إلى فهرس المنفذ SwitchPortIdx، وتكتب قيم العدادات مرة أخرى عبر المؤشر CounterPtr ([SWS_EthIf_91115]).

طريقة العمل وإعادة التوجيه

وفقًا لـ [SWS_EthIf_00432]، يعيد EthIf_SwitchPortGetCounterValues توجيه الطلب مباشرةً إلى الدالة EthSwt_GetCounterValues لمشغل مبدل Ethernet المعني. تستند قيم العدادات المُعادة إلى معايير 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: f181e127df41 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام والدلالات

تُستخدم الدالة EthIf_SwitchPortGetRxStats ([SWS_EthIf_91116]) للاستعلام عن عدادات إحصائيات الاستقبال لمنفذ محول Ethernet. وهي متوفرة عبر ملف الرأس EthIf.h وتُدار تحت معرّف الخدمة 0x52 ([SWS_EthIf_91116]).

يتطلب الاستدعاء المعلمات التالية ([SWS_EthIf_91116]):

  • SwitchIdx: فهرس مبدّل Ethernet في سياق برنامج تشغيل مبدّل Ethernet.
  • SwitchPortIdx: فهرس المنفذ في المبدّل المعنون.
  • RxStatsPtr: مؤشر إلى هيكل من النوع Eth_RxStatsType، تُكتب فيه قيم العدادات. تم اشتقاق الجزء الأكبر من هذه القيم من IETF RFC 2819 (قاعدة معلومات إدارة مراقبة الشبكة عن بعد).

قيم الإرجاع ومعالجة الأخطاء

تُرجع الدالة كنتيجة 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.

دليل المنفِّذ قيد الإعداد (التعقيد 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 55ba1781a74a المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة EthIf_SwitchPortGetTxStats لقراءة إحصائيات النقل وفقاً لـ IETF RFC1213 لمنفذ معين لمحول Ethernet [SWS_EthIf_91117]. وهي متوفرة عبر ملف الرأس EthIf.h مع معرّف الخدمة 0x53 [SWS_EthIf_91117].

الاستخدام والمعلمات

عند الاستدعاء، يتم تمرير فهرس المحول (SwitchIdx) وفهرس المنفذ في المحول المعنون (SwitchPortIdx) كمعلمات إدخال [SWS_EthIf_91117]. يتم توفير قراءات العداد المحددة عبر المؤشر TxStatsPtr من النوع Eth_TxStatsType* [SWS_EthIf_91117]. إذا كان العداد غير متاح أو غير مدعوم، فإن القيمة القصوى الممكنة للعداد تشير إلى قيمة غير صالحة [SWS_EthIf_91117].

قيم الإرجاع ومعالجة الأخطاء

تعيد الدالة حالة من النوع Std_ReturnType [SWS_EthIf_91117]:

لم يتم تحديد رموز خطأ محددة أو رسائل إلى DET أو DEM في المصادر، بحيث يجب معالجة حالات الخطأ في المقام الأول عبر قيمة الإرجاع E_NOT_OK [SWS_EthIf_91117].

التزامن والقيود

وفقًا للمواصفة، يُعرَّف EthIf_SwitchPortGetTxStats بأنه غير متزامن (Asynchronous) وغير قابل لإعادة الدخول (Non Reentrant) [SWS_EthIf_91117]. نظرًا لعدم توفر خاصية إعادة الدخول، لا يجوز إجراء استدعاءات متزامنة دون مزامنة ذات مستوى أعلى [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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 6f5b693504bb المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تقرأ الدالة المتزامنة EthIf_SwitchPortGetTxErrorCounterValues (معرف الخدمة 0x54) المتوفرة عبر EthIf.h قائمة بعدادات أخطاء الإرسال لمنفذ في مبدل Ethernet [SWS_EthIf_91118]. وتتوافق العدادات مع التعريفات الواردة في IETF RFC1213 وRFC1643، ويتم توفيرها عبر النوع Eth_TxErrorCounterValuesType في معامل الإخراج TxStatsPtr [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 بإعادة توجيه الاستدعاء مباشرة إلى الدالة EthSwt_GetTxErrorCounterValues لمشغل مبدل Ethernet المقابل [SWS_EthIf_00438].

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على متطلبات المواصفة.

دالة 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 6e598d708685 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تستعلم الدالة EthIf_SwitchPortGetMacLearningMode عن وضع تعلم MAC الحالي لمنفذ مبدل معين ([SWS_EthIf_91119]). وتشمل الأوضاع القابلة للتحديد: تفعيل التعلم العتادي، وتعطيل التعلم العتادي، بالإضافة إلى تفعيل التعلم البرمجي ([SWS_EthIf_91119]). يعتمد توفر هذه الدالة على العتاد، حيث يجب أن يدعم عتاد المبدل المعني أوضاع التعلم المختلفة ([SWS_EthIf_91119]).

سياق الاستدعاء والمعلمات

تُوفَّر الواجهة عبر ملف الترويسة EthIf.h وتمتلك معرّف الخدمة 0x55 ([SWS_EthIf_91119]). عند الاستدعاء، يجب تمرير المعلمات التالية:

  • SwitchIdx (دخل): فهرس المبدل ضمن سياق مشغل مبدل Ethernet ([SWS_EthIf_91119]).
  • SwitchPortIdx (دخل): فهرس المنفذ في المبدل المعنون ([SWS_EthIf_91119]).
  • MacLearningModePtr (خرج): مؤشر إلى موقع الذاكرة من النوع 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.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

دالة 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: b40bb6db2341 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الواجهة المتزامنة 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 (مفتوح)

أُنشئ هذا النص بواسطة ذكاء اصطناعي ويستند حصريًا إلى متطلبات المواصفة الخاصة بـ 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: ccaf63f78cda المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام والدلالات

تُستخدم الدالة EthIf_ReadPortMirrorConfiguration للاستعلام عن تكوين مطابقة المنافذ لمبدل Ethernet معين [SWS_EthIf_91123]. وهي مصرح عنها في ملف الترويسة EthIf.h وتمتلك معرّف الخدمة 0x59. حُدِّد سلوك التنفيذ بأنه غير متزامن (Asynchronous)، حيث يعيد الاستدعاء المباشر قيمة حالة من النوع Std_ReturnType [SWS_EthIf_91123].

المعلمات وقيم الإرجاع

  • MirroredSwitchIdx (دخل): فهرس مبدل Ethernet ضمن سياق مشغل مبدل Ethernet، الذي توجد عليه منافذ المبدل المراد مطابقتها [SWS_EthIf_91123].
  • PortMirrorConfigurationPtr (خرج): مؤشر إلى نطاق الذاكرة الذي يجب تخزين التكوين المقروء فيه [SWS_EthIf_91123].
  • قيمة الإرجاع: تشير E_OK إلى قراءة التكوين بنجاح. وفي حالة الخطأ، يتم إرجاع E_NOT_OK، على سبيل المثال إذا كان مبدل Ethernet المفهرس غير متاح [SWS_EthIf_91123].

التفاعل والتزامن

للتنفيذ، تقوم EthIf_ReadPortMirrorConfiguration بتمرير الاستدعاء مباشرة إلى الدالة EthSwt_ReadPortMirrorConfiguration الخاصة بمشغل مبدل Ethernet المقابل [SWS_EthIf_00448]. وتُعرَّف الدالة بأنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_EthIf_91123]؛ ولذلك يجب على الجهة المستدعية تجنب الاستدعاءات المتوازية للواجهة نفسها.

تستند ملاحظة الاستخدام هذه إلى مواصفات منصة AUTOSAR Classic الإصدار 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 61d650b885a8 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة المتزامنة EthIf_DeletePortMirrorConfiguration لحذف تكوين مطابقة منافذ مخزن لمبدل معين ([SWS_EthIf_91124]). وتمرر الجهة المستدعية عبر المعلمة Mirrored Switch Idx فهرس المبدل ضمن سياق مشغل مبدل Ethernet ([SWS_EthIf_91124]). تمتلك الواجهة معرّف الخدمة 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]).

فيما يتعلق بالتزامن، فإن الدالة قابلة لإعادة الدخول لفهارس المبدلات المختلفة (Mirrored Switch Idx)، ولكنها غير قابلة لإعادة الدخول عند الاستدعاءات المتعددة للفهرس نفسه ([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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: f443f14f320e المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة المتزامنة EthIf_SetPortMirrorState لضبط الحالة المطلوبة لتكوين مطابقة المنافذ لمبدل Ethernet محدد ([SWS_EthIf_91126]). وهي متاحة عبر ملف الترويسة EthIf.h ([SWS_EthIf_91126]).

تتوقع الدالة ثلاث معلمات عند الاستدعاء ([SWS_EthIf_91126]):

  • MirroredSwitchIdx: فهرس مبدّل Ethernet في سياق Ethernet Switch Driver، حيث يوجد تكوين نسخ المنفذ المتطابق المراد تنشيطه أو إلغاء تنشيطه.
  • PortIdx: فهرس المنفذ في مبدّل Ethernet المعنون.
  • PortMirrorState: الحالة المطلوب طلبها لمطابقة المنافذ، إما PORT_MIRRORING_ENABLED أو PORT_MIRRORING_DISABLED.

تشير قيمة الإرجاع من النوع Std_ReturnType إلى نتيجة الطلب ([SWS_EthIf_91126]):

  • E_OK: تم بنجاح ضبط الحالة المطلوبة لمنفذ المبدل المحدد.
  • E_NOT_OK: فشل الضبط، على سبيل المثال إذا كان المبدل المعنون غير متاح أو في حال عدم وجود تكوين لمطابقة المنافذ.

يتم التنفيذ بشكل متزامن وحُدِّد بأنه غير قابل لإعادة الدخول (Non Reentrant) ([SWS_EthIf_91126]). وضمن بنية الطبقات، تتولى واجهة Ethernet التوجيه: وفقًا لـ [SWS_EthIf_00454]، تقوم EthIf_SetPortMirrorState بتوجيه الاستدعاء مباشرة إلى الدالة EthSwt_SetPortMirrorState الخاصة بمشغل مبدل Ethernet المسؤول.

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR R20-11.

دليل المنفِّذ قيد الإعداد (التعقيد 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 3e1f0657b21d المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة EthIf_SetPortTestMode لتفعيل وضع اختبار محدد مسبقًا على منفذ مفهرس لمبدل Ethernet [SWS_EthIf_91127]. وتتوفر الخدمة المتزامنة عبر الترويسة EthIf.h بمعرّف الخدمة 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 بتوجيه الطلب مباشرة إلى الدالة ذات المستوى الأدنى EthSwt_SetPortTestMode الخاصة بمشغل مبدل Ethernet المقابل [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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 618d1a1fe688 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستخدم الدالة EthIf_SetPortLoopbackMode لتفعيل وضع استرجاع اختباري محدد مسبقًا لمنفذ مفهرس لمبدل Ethernet [SWS_EthIf_91128]. ويُوفَّر التصريح عبر ملف الترويسة EthIf.h [SWS_EthIf_91128]. عند الاستدعاء، يتم تمرير معلمات الدخل التالية:

  • SwitchIdx: فهرس مبدّل Ethernet ضمن سياق برنامج تشغيل مبدّل Ethernet [SWS_EthIf_91128].
  • PortIdx: فهرس المنفذ المعني في المبدل المعنون سابقًا [SWS_EthIf_91128].
  • Mode: وضع الاسترجاع المراد تفعيله من النوع EthTrcv_PhyLoopbackModeType [SWS_EthIf_91128].

التفاعل وإعادة التوجيه

لا تنفذ الدالة التكوين بشكل مستقل على مستوى العتاد. وبدلاً من ذلك، تقوم EthIf_SetPortLoopbackMode بتوجيه الاستدعاء مباشرة إلى الدالة EthSwt_SetPortLoopbackMode الخاصة بمشغل مبدل Ethernet المقترن بها [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]. ويجب منع الاستدعاءات المتوازية من قبل الجهة المستدعية. تفسير: نظرًا لأن الأمر يتعلق بتبديل أوضاع الاختبار، فمن المحتمل أن يتم الاستدعاء نمطيًا ضمن تسلسلات التهيئة أو الاختبار أو التشخيص على مستوى المهمة (Task). سؤال Q-cb4575c4a1d9c48b (مفتوح)

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على المواصفات.

دليل المنفِّذ قيد الإعداد (التعقيد 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: b8b46f4cfbae المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُفعِّل الدالة المتزامنة EthIf_SetPortTxMode وضع إرسال محددًا مسبقًا لمنفذ مبدل Ethernet مفهرس [SWS_EthIf_91129]. وهي متاحة عبر ملف الترويسة EthIf.h وتمتلك معرّف الخدمة 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 الإصدار R20-11.

دليل المنفِّذ قيد الإعداد (التعقيد 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 71c8b4be21c9 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُطلق الواجهة غير المتزامنة 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 بتوجيه الاستدعاء إلى الدالة 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 30a5efdd1b22 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُطلق الدالة EthIf_RunCableDiagnostic تشخيص الكابل لجهاز إرسال واستقبال Ethernet محدد [SWS_EthIf_91132]. وتُوفَّر عبر الترويسة EthIf.h وتُدرج تحت معرّف الخدمة 0x62 [SWS_EthIf_91132]. وتُستخدم TrcvIdx كمعلمة تمرير، والتي تمثل فهرس جهاز الإرسال والاستقبال الهدف ضمن سياق مشغل جهاز إرسال واستقبال Ethernet [SWS_EthIf_91132].

يتم التنفيذ بشكل غير متزامن [SWS_EthIf_91132]. وتشير قيمة الإرجاع من النوع Std_ReturnType إلى قبول المحفز:

معالجة الأخطاء

إذا رُفض تشخيص الكابل، تُعيد الدالة مباشرة E_NOT_OK [SWS_EthIf_91132]. ولم يتم تحديد أخطاء تطوير أو إنتاج محددة (DET/DEM) لهذه الدالة في هذه المواصفة.

التزامن والقيود

فيما يتعلق بالتزامن، تُعد EthIf_RunCableDiagnostic قابلة لإعادة الدخول (reentrant) للاستدعاءات ذات الفهارس المختلفة (TrcvIdx)، ولكنها غير قابلة لإعادة الدخول لنفس فهرس جهاز الإرسال والاستقبال (transceiver) [SWS_EthIf_91132]. يجب على جهة الاستدعاء منع طلبات التشخيص المتزامنة على نفس جهاز الإرسال والاستقبال. تفسير: نظرًا لأن الدالة تعمل بصورة غير متزامنة تمامًا ولا تُرجع بيانات نتائج، يُرجح أن توفير نتيجة التشخيص يتم عبر آلية منفصلة. سؤال Q-c65c009cd2e00dea (مفتوح)

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على المواصفة SWS_EthIf_91132.

دليل المنفِّذ قيد الإعداد (التعقيد 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: be1ed9572145 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم دالة الواجهة EthIf_SwitchGetCfgDataRaw لقراءة بيانات التكوين أو الذاكرة لمبدل Ethernet مفهرس بطول متغير [SWS_EthIf_91133]. وفي إطار النموذج الطبقي، لا تعالج الوحدة الاستدعاء بشكل مستقل، بل تعيد توجيهه مباشرةً إلى الدالة EthSwt_GetCfgDataRaw الخاصة ببرنامج تشغيل مبدل Ethernet المعني [SWS_EthIf_00468]. تم التصريح عن الدالة في ملف الرأس EthIf.h وتملك معرّف الخدمة 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: b29ad2e3bc3d المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تحدد الدالة EthIf_SwitchGetCfgDataInfo الحجم الإجمالي لبيانات التكوين بالإضافة إلى عنوان البدء لسجلات التكوين لمبدل Ethernet مفهرس [SWS_EthIf_91134]. تم التصريح عن الواجهة في ملف الرأس EthIf.h وتُدار تحت معرّف الخدمة 0x64 [SWS_EthIf_91134].

تستقبل الدالة المعاملات التالية [SWS_EthIf_91134]:

  • SwitchIdx (دخل): فهرس مبدل Ethernet في سياق برنامج تشغيل مبدل Ethernet.
  • DataSizePtr (خرج): مؤشر إلى موقع الذاكرة المراد نسخ الحجم الإجمالي لبيانات التكوين إليه.
  • DataAdressPtr (خرج): مؤشر إلى موقع الذاكرة المراد نسخ عنوان البدء لسجلات التكوين إليه.

تُرجع الدالة كقيمة إرجاع E_OK إذا تم جلب البيانات بنجاح، أو E_NOT_OK في حال فشل العملية، على سبيل المثال لعدم توفر المبدل المفهرس [SWS_EthIf_91134]. لم يتم تعريف رموز أخطاء محددة لـ DET أو DEM لهذه الخدمة ضمن نطاق المواصفة الحالي.

بالنسبة لسياق الاستدعاء، حُددت الدالة على أنها قابلة لإعادة الدخول وكذلك رسميًا على أنها غير متزامنة [SWS_EthIf_91134]. وبما أنه لم يتم تحديد آليات معاودة اتصال (callback)، يُرجح أن توفير البيانات يكون متاحًا فورًا عند الرجوع من E_OK (تفسير: يشير التصنيف غير المتزامن على الأرجح إلى عمليات وصول داخلية لبرنامج التشغيل). سؤال Q-bf49882a16548ea4 (مفتوح)

تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويستند إلى متطلبات معيار AUTOSAR.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

دالة EthIf_SwitchPortGetMaxFIFOBufferFillLevel [SWS_EthIf_91135] 📄 PDF

Std_ReturnType EthIf_SwitchPortGetMaxFIFOBufferFillLevel (uint8 SwitchPortIdx, uint8 PortIdx, uint8 SwitchPortEgressFifoIdx, uint32* SwitchPortEgressFifoBufferLevelPtr);

Service EthIf_SwitchPortGetMaxFIFOBufferFillLevel.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: c2027ddc769c المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام والاستدعاء

تحدد الدالة EthIf_SwitchPortGetMaxFIFOBufferFillLevel أقصى مساحة مخصصة لمخزن FIFO المؤقت (بالبايت) منذ آخر وصول للقراءة لمنفذ خروج (egress port) محدد لمبدل Ethernet [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]. تعيد الوحدة توجيه الاستدعاء لمزيد من التنفيذ إلى دالة برنامج التشغيل EthSwt_GetMaxFIFOBufferFillLevel الخاصة ببرنامج تشغيل مبدل Ethernet المرتبط [SWS_EthIf_00472].

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على المواصفات.

دالة 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 4607d60f7e1b المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام والدلالات

تُستخدم الدالة EthIf_TransceiverGetMacMethod (معرّف الخدمة 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 مع 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]. لذا يجب على جهة الاستدعاء استبعاد حدوث استدعاء متزامن أو مقاطِع ضمن نفس سياق المشغل. وتجدر الإشارة أيضًا إلى أن الخدمة محددة في الإصدار R20-11 بالحالة atp.Status=draft [SWS_EthIf_91021].

تم إنشاء ملاحظة الاستخدام هذه تلقائيًا استنادًا إلى مواصفة AUTOSAR الخاصة بـ EthIf_TransceiverGetMacMethod.

دليل المنفِّذ قيد الإعداد (التعقيد 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: f4f8ac8a7932 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام والدلالات

تعالج الدالة المتزامنة EthIf_RxIndication إطار Ethernet تم استلامه عبر وحدة تحكم Ethernet فعلية مفهرسة [SWS_EthIf_00085]. لا تمتلك الخدمة قيمة مرجعة، وتتولى إعادة توجيه البيانات المستلمة داخل واجهة Ethernet [SWS_EthIf_00085]. تفسير: من المفترض عادةً أن يتم الاستدعاء بواسطة برنامج تشغيل Ethernet التابع (Eth) بمجرد توفر بيانات الاستلام الجديدة بالكامل. سؤال Q-c3d25d0b89e6cd7f (مفتوح)

المعلمات

لمواصلة المعالجة، تستقبل الدالة المعاملات التالية [SWS_EthIf_00085]:

  • CtrlIdx: فهرس وحدة تحكم Ethernet الفعلية في سياق واجهة Ethernet [SWS_EthIf_00085].
  • FrameType: نوع الإطار لإطار Ethernet المستلم [SWS_EthIf_00085].
  • IsBroadcast: علامة تشير إلى ما إذا كان الإطار إطار بث عام (Broadcast) [SWS_EthIf_00085].
  • PhysAddrPtr: مؤشر إلى العنوان الفعلي للمصدر (عنوان MAC بترتيب بايتات الشبكة) للإطار المستلم [SWS_EthIf_00085].
  • DataPtr: مؤشر إلى بيانات الحمولة (Payload) للإطار المُستلَم [SWS_EthIf_00085].
  • LenByte: طول البيانات المفيدة في الإطار المستلم بالبايت [SWS_EthIf_00085].

التزامن والقيود

تم التصريح عن الواجهة على أنها غير قابلة لإعادة الدخول (Non Reentrant) وهي متوفرة تحت معرّف الخدمة 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: da5fb02ebb8b المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام وسياق الاستدعاء

تؤكد الدالة المتزامنة EthIf_TxConfirmation (معرّف الخدمة 0x11) إرسال إطار Ethernet بواسطة وحدة تحكم Ethernet الفعلية المشار إليها عبر CtrlIdx [SWS_EthIf_00091]. لا تمتلك الدالة أي قيمة مرجعة وتتوفر عبر ملف الرأس EthIf.h [SWS_EthIf_00091].

تُحدَّد معلمات الإدخال على النحو التالي [SWS_EthIf_00091]:

  • CtrlIdx (uint8): فهرس وحدة تحكم Ethernet المادية في سياق واجهة Ethernet.
  • BufIdx (Eth_BufIdxType): فهرس المخزن المؤقت المنقول.
  • Result (Std_ReturnType): نتيجة النقل؛ تشير E_OK إلى نجاح عملية الإرسال، بينما تشير E_NOT_OK إلى حدوث خطأ في النقل.

التفاعل مع الطبقات العليا

وفقًا لـ [SWS_EthIf_00255]، تُمرر EthIf_TxConfirmation نتيجة النقل المستلمة Result إلى الطبقة العليا المهيأة عبر دالة رد النداء الخاصة بها <UL>_TxConfirmation.

التزامن والقيود

الدالة محددة على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_EthIf_00091]. لذلك، يجب تجنب الاستدعاءات المتزامنة. لا ينص مقتطف المواصفات على رسائل خطأ محددة لـ DET أو DEM؛ ويتم إرسال الأخطاء حصريًا عبر المعلمة Result بالقيمة E_NOT_OK [SWS_EthIf_00091].

أُنشئ هذا النص تلقائيًا بواسطة ذكاء اصطناعي.

دليل المنفِّذ قيد الإعداد (التعقيد 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 01a40e36c664 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستدعى دالة الإشعار EthIf_CtrlModeIndication وفقًا لـ [SWS_EthIf_00231] بمجرد قراءة نمط تشغيل وحدة تحكم Ethernet بنجاح. ويحدث الإطلاق بشكل غير متزامن نتيجة لاستدعاء سابق لـ Eth_SetControllerMode، مع إمكانية حدوث الاستدعاء مباشرةً داخل دوال الإطلاق المعنية. وتتميز الدالة نفسها بدلالات تنفيذ متزامنة ولا ترجع أي قيمة إرجاع ([SWS_EthIf_00231]).

عبر المعلمات، يُمرر فهرس وحدة تحكم Ethernet المادية في سياق واجهة Ethernet (CtrlIdx) بالإضافة إلى نمط وحدة التحكم المُبلَّغ عنه (CtrlMode) ([SWS_EthIf_00231]). وفيما يتعلق بالتزامن، تحدد [SWS_EthIf_00231] أن الدالة غير قابلة لإعادة الدخول لنفس فهرس وحدة التحكم، ولكن يجوز تنفيذها بشكل قابل لإعادة الدخول لفهارس مختلفة.

فيما يتعلق بالتفاعل مع الوحدات النمطية الأخرى، تشير المتطلبات ذات الصلة إلى إجراءات لاحقة، إلا أنها تُصنف على أنها مهملة (obsolete) في هذا الإصدار:

  • وفقًا لـ [SWS_EthIf_00267] (OBSOLETE)، كان من المقرر في سياق هذه الدالة استدعاء EthSwt_SetSwitchPortMode لجميع منافذ مجموعة منافذ المبدل، بشرط وجود مرجع تحكم مطابق، وحل التعارضات مع المجموعات النشطة عند ETH_MODE_DOWN.
  • وفقًا لـ [SWS_EthIf_00413] (OBSOLETE)، كان من المقرر في سياق هذه الدالة، في حال وجود مرجع لجهاز الإرسال والاستقبال، استدعاء EthTrcv_TransceiverLinkStateRequest مع ETHTRCV_LINK_STATE_ACTIVE أو ETHTRCV_LINK_STATE_DOWN، اعتمادًا على ما إذا كان ETH_MODE_ACTIVE أو ETH_MODE_DOWN قد طُلِب مسبقًا.

تم توليد هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR CP R20-11.

دليل المنفِّذ قيد الإعداد (التعقيد 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 3c15a8bf107b المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام والدلالات

تُستخدم الدالة EthIf_TrcvModeIndication كواجهة إشعار لواجهة Ethernet، ويتم استدعاؤها بمجرد قراءة تغيير وضع جهاز الإرسال والاستقبال [SWS_EthIf_00232]. وتتوفر عبر ملف الرأس EthIf.h وتمتلك معرّف الخدمة 0x0f [SWS_EthIf_00232].

تم تحديد تنفيذ الدالة نفسها بأنه متزامن، في حين يتم الاستدعاء بشكل غير متزامن عند تحديد تغيير الوضع [SWS_EthIf_00232]. وإذا تم إطلاق الدالة من خلال استدعاء سابق لـ EthTrcv_SetTransceiverMode، فيجوز استدعاؤها مباشرةً داخل هذه الدالة المطلقة [SWS_EthIf_00232].

المعلمات وقيم الإرجاع

  • TrcvIdx: فهرس جهاز إرسال واستقبال Ethernet في سياق واجهة Ethernet (معامل دخل) [SWS_EthIf_00232].
  • TrcvMode: وضع التشغيل المشار إليه لجهاز إرسال واستقبال Ethernet من النوع 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()

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 57f47c2f8434 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة EthIf_SwitchPortModeIndication بواسطة واجهة Ethernet Interface (EthIf) كواجهة إشعار غير متزامنة بشأن تغيير وضع منفذ محول Ethernet الذي يبلّغ عنه مشغل محول Ethernet Switch Driver [SWS_EthIf_91055].

الاستخدام والتكامل

تحدد EthIf الإشعارات المتوقعة بناءً على تهيئة منفذ المحول المعني: إذا كان منفذ المحول يشير إلى جهاز إرسال واستقبال (EthTrcv)، فإن EthIf تتوقع بدلاً من ذلك إشعاراً عبر EthIf_TrcvModeIndication()؛ وإلا فإنه يُتوقع الإشعار من Ethernet Switch Driver عبر EthIf_SwitchPortModeIndication() [SWS_EthIf_91055].

  • SwitchIdx: فهرس محول Ethernet في سياق Ethernet Switch Driver [SWS_EthIf_91055].
  • SwitchPortIdx: فهرس المنفذ في محول Ethernet المعنون [SWS_EthIf_91055].
  • PortMode: الوضع الجديد المبلغ عنه لمنفذ المحول من النوع Eth_ModeType [SWS_EthIf_91055].

خصائص التنفيذ والقيود

ليس للدالة أي قيمة إرجاع (void) ولها معرّف الخدمة 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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: d3c958a96e74 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام وسياق الاستدعاء

تُستخدم الدالة EthIf_SleepIndication كواجهة إخطار لواجهة Ethernet. ويتم استدعاؤها من مشغل جهاز إرسال واستقبال Ethernet المعني (EthTrcv) بمجرد تسجيله لدلالة نوم على الشبكة [SWS_EthIf_91006]. ويتم تمرير TrcvIdx كمعامل إدخال وحيد، وهو يحدد بصورة فريدة فهرس جهاز إرسال واستقبال Ethernet المُرسِل للإشارة في سياق الوحدة النمطية EthIf [SWS_EthIf_91006]. لا تحتوي الدالة على معلمات إدخال/إخراج أو قيم إرجاع، وتنفذ الإخطار بشكل متزامن [SWS_EthIf_91006].

التفاعل مع العتاد

إحدى حالات الاستخدام الأساسية هي الاستخدام مع عتاد Ethernet المصمم بما يتوافق مع مواصفات OPEN Alliance TC10 [SWS_EthIf_91006]. في هذا السيناريو، يكتشف جهاز الإرسال والاستقبال (PHY) على مستوى العتاد Sleep.Indication تم إطلاقها بواسطة طلب نوم (Sleep.Request) من شريك الربط (Link Partner) المتصل مباشرة [SWS_EthIf_91006].

التزامن والقيود

تُعرّف الواجهة بأنها متزامنة وقابلة لإعادة الدخول، وتُتاح عبر ملف الرأس EthIf.h (معرف الخدمة 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 26bf586c58f7 المصدر أسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام وسياق الاستدعاء

تتولى الدالة EthIf_MainFunctionRx في واجهة Ethernet (EthIf) المهمة المركزية المتمثلة في الفحص في وضع الاستطلاع بحثًا عن أطر بيانات واردة حديثًا وإطلاق إشعارات الاستقبال (Reception Indications) المقابلة للطبقات الأعلى [SWS_EthIf_00097]. وهي معرّفة بالتوقيع void EthIf_MainFunctionRx (void)، وبالتالي لا تأخذ أي معاملات استدعاء ولا تُرجع أي قيمة [SWS_EthIf_00097]. وتم تحديد القيمة الست عشرية 0x20 كمعرّف للخدمة [SWS_EthIf_00097].

تتوفر الدالة عبر ملف الرأس SchM_EthIf.h [SWS_EthIf_00097]. وهذا يدعم التفسير بأن استدعاءها يتم دوريًا بواسطة Schedule Manager (SchM) أو نظام التشغيل ضمن سياق مهمة دورية لبرمجيات الطبقة الأساسية (BSW).

التزامن ومعالجة الأخطاء

نظرًا لأن فحص وإعادة توجيه الأطر المستلمة محدد في وضع الاستطلاع [SWS_EthIf_00097]، فإن عملية الاستقبال السلسة تتطلب توقيتًا زمنيًا مناسبًا للاستدعاء. ومن المرجح أن يؤدي التنفيذ المتأخر إلى حدوث تأخيرات في إعادة توجيه الرسائل الواردة إلى طبقات البرمجيات العليا. سؤال Q-554ef0cf302c3aa3 (مفتوح) ولا تتضمن المواصفات أي رموز أخطاء محددة، أو أخطاء تطوير (DET)، أو تقارير أخطاء إلى DEM لهذه الدالة.

تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي وتلخص متطلبات إصدار المواصفات 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: c427e9416514 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة الرئيسية EthIf_MainFunctionTx للمعالجة الدورية لعمليات الإرسال واستعلامات الحالة داخل وحدة واجهة Ethernet [SWS_EthIf_00113]. وتمتلك معرّف الخدمة الست عشري 0x21، ويتم تنفيذها وفقًا لتوقيعها void EthIf_MainFunctionTx (void) بدون معاملات تمرير وبدون قيمة إرجاع، بحيث تتم المعالجة بأكملها بناءً على الحالة [SWS_EthIf_00113].

أثناء التشغيل، تتولى الخدمة مهمتين مركزيتين في اتصال Ethernet:

  • تأكيدات الإرسال: في وضع الاستطلاع، تصدر الدالة تأكيدات لعمليات الإرسال المكتملة بنجاح (Transmission Confirmations) إلى الطبقات الأعلى [SWS_EthIf_00113].
  • حالات جهاز الإرسال والاستقبال: تراقب وتفحص النظام بحثًا عن تغييرات الحالة التي طرأت على أجهزة إرسال واستقبال Ethernet المتصلة [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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: ad2bcae76976 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام والدلالات

تُستخدم الدالة EthIf_MainFunctionState للاستعلام الدوري (polling) عن معلومات الحالة والتشخيص لعتاد اتصالات Ethernet المتصل، مثل أجهزة إرسال واستقبال Ethernet ومنافذ مبدل Ethernet [SWS_EthIf_91104]. ويشمل ذلك، على سبيل المثال، حالة الرابط (Link State) وجودة الإشارة [SWS_EthIf_91104]. لا تحتوي الدالة على معلمات إدخال أو إخراج ولا تُعيد أي قيمة (void EthIf_MainFunctionState(void)، معرف الخدمة 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 ولا تحل محل اختبار التكامل الشكلي.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

نوع 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_SignalQualityResultType [SWS_EthIf_91057] 📄 PDF

-

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: c6d5744fb7a0 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يُستخدم هيكل البيانات EthIf_SignalQualityResultType ([SWS_EthIf_91057]) للحصول على جودة الاتصال وتشخيصها على مستوى Ethernet، ويتم توفيره عبر ملف الترويسة EthIf.h.

يجمع الهيكل ثلاثة مقادير قياس من النوع الأساسي uint32:

  • ActualSignalQuality: يمثل جودة الإشارة المطبقة حاليًا لوصلة Ethernet.
  • HighestSignalQuality: يسجل أعلى جودة إشارة مقاسة للوصلة منذ آخر إعادة تعيين.
  • LowestSignalQuality: يوثق أدنى جودة إشارة مقاسة للوصلة منذ آخر إعادة تعيين.

في إطار التفاعل مع الوحدة النمطية EthIf، تعكس القيم القصوى والدنيا مسار استقرار الاتصال. ويتم التحكم في إعادة تعيين قيم السجل المحفوظة داخليًا عبر واجهات مخصصة:

  • بالنسبة لجهاز إرسال واستقبال محدد عبر TrcvIdx، تقوم الدالة EthIf_ClearTrcvSignalQuality بإعادة تعيين قيم جودة الإشارة المخزنة ([SWS_EthIf_00400]).
  • بالنسبة لمنفذ مبدل محدد عبر SwitchIdx وSwitchPortIdx، تمسح EthIf_ClearSwitchPortSignalQuality قيم جودة الإشارة المخزنة ([SWS_EthIf_00404]).

استنتاج: نظرًا لأن حمولة البيانات لا تذكر دالة قراءة محددة، فمن المحتمل أن يُستخدم الهيكل كمعلمة إخراج لطلبات الحالة المقابلة لأجهزة الإرسال والاستقبال ومنافذ المبدلات، لمقارنة جودة الإشارة الحالية بالقيم القصوى والدنيا. سؤال Q-8e5f2914bade574c (مفتوح)

تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويستند حصريًا إلى متطلبات المواصفات من 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#1a17177d
Content hash
1a17177d
Source
https://www.autosar.org/fileadmin/standards/R20-11/CP/AUTOSAR_SWS_EthernetInterface.pdf#nameddest=SWS_EthIf_00024

خريطة المواضيع

التهيئة والحالة

2
EthIf_GetVersionInfoEthIf_Init

الخدمات · Get…

28
EthIf_GetAndResetMeasurementDataEthIf_GetArlTableEthIf_GetBufWRxParamsEthIf_GetBufWTxParamsEthIf_GetCableDiagnosticsResultEthIf_GetChanRxParamsEthIf_GetControllerModeEthIf_GetCtrlIdxListEthIf_GetCurrentTimeEthIf_GetEgressTimeStampEthIf_GetIngressTimeStampEthIf_GetPhyIdentifierEthIf_GetPhysAddrEthIf_GetPhyWakeupReasonEthIf_GetPortCableDiagnosticsResultEthIf_GetPortMacAddrEthIf_GetPortMirrorStateEthIf_GetRxMgmtObjectEthIf_GetSwitchIdentifierEthIf_GetSwitchPortIdentifierEthIf_GetSwitchPortModeEthIf_GetSwitchPortSignalQualityEthIf_GetSwitchPortWakeupReasonEthIf_GetTransceiverModeEthIf_GetTransceiverWakeupModeEthIf_GetTrcvSignalQualityEthIf_GetTxMgmtObjectEthIf_GetVlanId

الخدمات · Set…

16
EthIf_SetBufWTxParamsEthIf_SetChanRxParamsEthIf_SetChanTxParamsEthIf_SetControllerModeEthIf_SetForwardingModeEthIf_SetPhyLoopbackModeEthIf_SetPhysAddrEthIf_SetPhyTestModeEthIf_SetPhyTxModeEthIf_SetPortLoopbackModeEthIf_SetPortMirrorStateEthIf_SetPortTestModeEthIf_SetPortTxModeEthIf_SetRadioParamsEthIf_SetSwitchMgmtInfoEthIf_SetTransceiverWakeupMode

الخدمات · Switch…

14
EthIf_SwitchEnableTimeStampingEthIf_SwitchGetCfgDataInfoEthIf_SwitchGetCfgDataRawEthIf_SwitchPortGetBaudRateEthIf_SwitchPortGetCounterValuesEthIf_SwitchPortGetDuplexModeEthIf_SwitchPortGetLinkStateEthIf_SwitchPortGetMacLearningModeEthIf_SwitchPortGetMaxFIFOBufferFillLevelEthIf_SwitchPortGetRxStatsEthIf_SwitchPortGetTxErrorCounterValuesEthIf_SwitchPortGetTxStatsEthIf_SwitchPortGroupRequestModeEthIf_SwitchPortModeIndication

الخدمات · Transceiver…

4
EthIf_TransceiverGetBaudRateEthIf_TransceiverGetDuplexModeEthIf_TransceiverGetLinkStateEthIf_TransceiverGetMacMethod

الخدمات · أخرى

19
EthIf_CheckWakeupEthIf_ClearSwitchPortSignalQualityEthIf_ClearTrcvSignalQualityEthIf_CtrlModeIndicationEthIf_DeletePortMirrorConfigurationEthIf_EnableEgressTimeStampEthIf_ProvideTxBufferEthIf_ReadPortMirrorConfigurationEthIf_ResetConfigurationEthIf_RunCableDiagnosticEthIf_RunPortCableDiagnosticEthIf_SleepIndicationEthIf_StartAllPortsEthIf_StoreConfigurationEthIf_TransmitEthIf_TrcvModeIndicationEthIf_UpdatePhysAddrFilterEthIf_VerifyConfigEthIf_WritePortMirrorConfiguration

دوال الاستدعاء الراجع

2
EthIf_RxIndicationEthIf_TxConfirmation

دورية

3
EthIf_MainFunctionRxEthIf_MainFunctionStateEthIf_MainFunctionTx

الأنواع

4
EthIf_ConfigTypeEthIf_MeasurementIdxTypeEthIf_SignalQualityResultTypeEthIf_SwitchPortGroupIdxType

عرض التفاصيل

اختر عنصرًا من المخطط.

التهيئة والحالة

EthIf_GetVersionInfo دالة

Returns the version information of this module

void EthIf_GetVersionInfo (Std_VersionInfoType* VersionInfoPtr);
EthIf_Init دالة

Initializes the Ethernet Interface

void EthIf_Init (const EthIf_ConfigType* CfgPtr);

الخدمات · Get…

EthIf_GetAndResetMeasurementData دالة

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.

Std_ReturnType EthIf_GetAndResetMeasurementData (EthIf_MeasurementIdxType MeasurementIdx, boolean MeasurementResetNeeded, uint32* MeasurementDataPtr);
EthIf_GetArlTable دالة

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

Std_ReturnType EthIf_GetArlTable (uint8 switchIdx, uint16* numberOfElements, Eth_MacVlanType* arlTableListPointer);
EthIf_GetBufWRxParams دالة

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.

Std_ReturnType EthIf_GetBufWRxParams (uint8 CtrlIdx, const WEth_BufWRxParamIdType* RxParamIds, uint32* ParamValues, uint8 NumParams);
EthIf_GetBufWTxParams دالة

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.

Std_ReturnType EthIf_GetBufWTxParams (uint8 CtrlIdx, const WEth_BufWTxParamIdType* TxParamIds, uint32* ParamValues, uint8 NumParams);
EthIf_GetCableDiagnosticsResult دالة

Retrieves the cable diagnostics result of a given transceiver.

Std_ReturnType EthIf_GetCableDiagnosticsResult (uint8 TrcvIdx, EthTrcv_CableDiagResultType* ResultPtr);
EthIf_GetChanRxParams دالة

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).

Std_ReturnType EthIf_GetChanRxParams (uint8 TrcvId, uint8 RadioId, const WEthTrcv_GetChanRxParamIdType* ParamIds, thernetInterface uint32* ParamValues, uint8 NumParams); ⚠️
EthIf_GetControllerMode دالة

Obtains the state of the ind exed controller

Std_ReturnType EthIf_GetControllerMode (uint8 CtrlIdx, Eth_ModeType* CtrlModePtr);
EthIf_GetCtrlIdxList دالة

Returns the number and index of all active Ethernet controllers.

Std_ReturnType EthIf_GetCtrlIdxList (uint8* NumberOfCtrlIdx, uint8* CtrlIdxListPtr);
EthIf_GetCurrentTime دالة

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.

Std_ReturnType EthIf_GetCurrentTime (uint8 CtrlIdx, Eth_TimeStampQualType* timeQualPtr, Eth_TimeStampType* timeStampPtr);
EthIf_GetEgressTimeStamp دالة

Reads back the egress time stamp on a dedicated message object. It must be called within the Tx Confirmation() function.

Std_ReturnType EthIf_GetEgressTimeStamp (uint8 CtrlIdx, Eth_BufIdxType BufIdx, Eth_TimeStampQualType* timeQualPtr, thernetInterface* timeStampPtr); ⚠️
EthIf_GetIngressTimeStamp دالة

Reads back the ingress time stamp on a dedicated message object. It must be called within the Rx Indication() function.

Std_ReturnType EthIf_GetIngressTimeStamp (uint8 CtrlIdx, const Eth_DataType* DataPtr, Eth_TimeStampQualType* timeQualPtr, Eth_TimeStampType* timeStampPtr);
EthIf_GetPhyIdentifier دالة

Obtains the PHY identifier of the Ethernet Interface according to IEEE 802.3 - chapter 22.2.4.3.1 PHY Identifer.

Std_ReturnType EthIf_GetPhyIdentifier (uint8 TrcvIdx, uint32* OrgUniqueIdPtr, uint8* ModelNrPtr, uint8* RevisionNrPtr);
EthIf_GetPhysAddr دالة

Obtains the physical source address used by the indexed controller

void EthIf_GetPhysAddr (uint8 CtrlIdx, uint8* PhysAddrPtr);
EthIf_GetPhyWakeupReason دالة

Tags: atp.Status=draft

Std_ReturnType EthIf_GetPhyWakeupReason (uint8 TrcvIdx, EthTrcv_WakeupReasonType* WakeupReasonPtr);
EthIf_GetPortCableDiagnosticsResult دالة

Retrieves the cable diagnostics result of the indexed Ethernet switch port respectively the referenced Ethernet Transceiver Driver.

Std_ReturnType EthIf_GetPortCableDiagnosticsResult (uint8 SwitchIdx, uint8 PortIdx, EthTrcv_CableDiagResultType* ResultPtr);
EthIf_GetPortMacAddr دالة

Obtains the port over which this MAC - address can be reached

Std_ReturnType EthIf_GetPortMacAddr (const uint8* MacAddrPtr, uint8* SwitchIdxPtr, uint8* PortIdxPtr);
EthIf_GetPortMirrorState دالة

Obtain the current status of the port mirroring for the indexed Ethernet switch port

Std_ReturnType EthIf_GetPortMirrorState (uint8 SwitchIdx, uint8 PortIdx, EthSwt_PortMirrorStateType* PortMirrorStatePtr);
EthIf_GetRxMgmtObject دالة

Request the Mgmt Object of the (in this context) unique Data Ptr.

Std_ReturnType EthIf_GetRxMgmtObject (uint8 CtrlIdx, Eth_DataType* DataPtr, EthSwt_MgmtObjectType* * MgmtObjectPtr);
EthIf_GetSwitchIdentifier دالة

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

Std_ReturnType EthIf_GetSwitchIdentifier (uint8 SwitchIdx, uint32* OrgUniqueIdPtr);
EthIf_GetSwitchPortIdentifier دالة

This function retrieves the OUI (24 bit) of the indexed Ethernet switch port.

Std_ReturnType EthIf_GetSwitchPortIdentifier (uint8 SwitchIdx, uint8 SwitchPortIdx, uint32* OrgUniqueIdPtr, uint8* ModelNrPtr, uint8* RevisionNrPtr);
EthIf_GetSwitchPortMode دالة

Obtains the mode of the indexed switch port

Std_ReturnType EthIf_GetSwitchPortMode (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_ModeType* PortModePtr);
EthIf_GetSwitchPortSignalQuality دالة

Retrieves the signal quality of the link of the given Ethernet switch port

Std_ReturnType EthIf_GetSwitchPortSignalQuality (uint8 SwitchIdx, uint8 SwitchPortIdx, EthIf_SignalQualityResultType* ResultPtr);
EthIf_GetSwitchPortWakeupReason دالة

This function obtains the wake up reasons of the indexed Ethernet switch port by

Std_ReturnType EthIf_GetSwitchPortWakeupReason (uint8 SwitchIdx, uint8 SwitchPortIdx, EthTrcv_WakeupReasonType* WakeupReasonPtr);
EthIf_GetTransceiverMode دالة

Obtains the state of the indexed transceiver

Std_ReturnType EthIf_GetTransceiverMode (uint8 TrcvIdx, Eth_ModeType* TrcvModePtr);
EthIf_GetTransceiverWakeupMode دالة

Returns the wake up mode of the indexed tran sceiver Tags: atp.Status=obsolete

Std_ReturnType EthIf_GetTransceiverWakeupMode (uint8 TrcvIdx, EthTrcv_WakeupModeType* TrcvWakeupModePtr);
EthIf_GetTrcvSignalQuality دالة

Retrieves the signal quality of the link of the given Ethernet transceiver

Std_ReturnType EthIf_GetTrcvSignalQuality (uint8 TrcvIdx, EthIf_SignalQualityResultType* ResultPtr);
EthIf_GetTxMgmtObject دالة

Request the Mgmt Object of the (in this context) unique Buf Idx.

Std_ReturnType EthIf_GetTxMgmtObject (uint8 CtrlIdx, Eth_BufIdxType BufIdx, EthSwt_MgmtObjectType* * MgmtObjectPtr);
EthIf_GetVlanId دالة

Returns the VLAN identifier of the requested Ethernet controller.

Std_ReturnType EthIf_GetVlanId (uint8 CtrlIdx, uint16* VlanIdPtr);

الخدمات · Set…

EthIf_SetBufWTxParams دالة

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.

Std_ReturnType EthIf_SetBufWTxParams (uint8 CtrlIdx, Eth_BufIdxType BufIdx, const WEth_BufWTxParamIdType* TxParamIds, const uint32* ParamValues, uint8 NumParams);
EthIf_SetChanRxParams دالة

Set values related to the receive direction of a transceiver's wireless channel. For example, this could be a channel parameter like the frequency.

Std_ReturnType EthIf_SetChanRxParams (uint8 TrcvId, uint8 RadioId, const WEthTrcv_SetChanRxParamIdType* ParamIds, const uint32* ParamValues, uint8 NumParams);
EthIf_SetChanTxParams دالة

Set values related to the transmit direction of a transceiver's wireless channel. For example, this could be the bitrate of a channel.

Std_ReturnType EthIf_SetChanTxParams (uint8 TrcvId, uint8 RadioId, const WEthTrcv_SetChanTxParamIdType* TxParamIds, const uint32* ParamValues, uint8 NumParams);
EthIf_SetControllerMode دالة

Enables / disables the indexed controller thernet Interface AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_EthernetInterface

Std_ReturnType EthIf_SetControllerMode (uint8 CtrlIdx, Eth_ModeType CtrlMode);
EthIf_SetForwardingMode دالة

Verifies the Switch Configuration. If Configuration is not valid, Switch is reconfigured.

Std_ReturnType EthIf_SetForwardingMode (uint8 SwitchIdx, boolean mode);
EthIf_SetPhyLoopbackMode دالة

Activates a given loopback mode.

Std_ReturnType EthIf_SetPhyLoopbackMode (uint8 TrcvIdx, EthTrcv_PhyLoopbackModeType Mode);
EthIf_SetPhysAddr دالة

Sets the physical source address used by the indexed controller.

void EthIf_SetPhysAddr (uint8 CtrlIdx, const uint8* PhysAddrPtr);
EthIf_SetPhyTestMode دالة

Activates a given test mode.

Std_ReturnType EthIf_SetPhyTestMode (uint8 TrcvIdx, EthTrcv_PhyTestModeType Mode);
EthIf_SetPhyTxMode دالة

Activates a given transmission mode. Tags: atp.Status=draft

Std_ReturnType EthIf_SetPhyTxMode (uint8 TrcvIdx, EthTrcv_PhyTxModeType Mode);
EthIf_SetPortLoopbackMode دالة

Activates a given test loop - back mode of the indexed Ethernet switch port.

Std_ReturnType EthIf_SetPortLoopbackMode (uint8 SwitchIdx, uint8 PortIdx, EthTrcv_PhyLoopbackModeType Mode);
EthIf_SetPortMirrorState دالة

Request to set the given port mirroring state of the port mirror configuration for the given Ethernet switch.

Std_ReturnType EthIf_SetPortMirrorState (uint8 MirroredSwitchIdx, uint8 PortIdx, EthSwt_PortMirrorStateType PortMirrorState);
EthIf_SetPortTestMode دالة

Activates a given test mode of the indexed Ethernet switch port.

Std_ReturnType EthIf_SetPortTestMode (uint8 SwitchIdx, uint8 PortIdx, EthTrcv_PhyTestModeType Mode);
EthIf_SetPortTxMode دالة

Activates a given transmission mode of the indexed Ethernet switch port.

Std_ReturnType EthIf_SetPortTxMode (thernetInterface uint8 SwitchIdx, uint8 PortIdx, EthTrcv_PhyTxModeType Mode); ⚠️
EthIf_SetRadioParams دالة

Set values related to a transceiver's wireless radio. For example, this could be the selection of the radio settings (channel, ...).

Std_ReturnType EthIf_SetRadioParams (uint8 TrcvId, const WEthTrcv_SetRadioParamIdType* ParamIds, const uint32* ParamValue, uint8 NumParams);
EthIf_SetSwitchMgmtInfo دالة

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.

Std_ReturnType EthIf_SetSwitchMgmtInfo (uint8 CtrlIdx, Eth_BufIdxType BufIdx, EthSwt_MgmtInfoType* MgmtInfoPtr);
EthIf_SetTransceiverWakeupMode دالة

Enables / disables the wake up mode or clear the wake - up reason of the indexed transceiver Tags: atp.Status=obsolete

Std_ReturnType EthIf_SetTransceiverWakeupMode (uint8 TrcvIdx, EthTrcv_WakeupModeType TrcvWakeupMode);

الخدمات · Switch…

EthIf_SwitchEnableTimeStamping دالة

Activates egress time stamping on a dedicated message object, addressed by Ctrl Idx and Buf Idx.

Std_ReturnType EthIf_SwitchEnableTimeStamping (uint8 CtrlIdx, Eth_BufIdxType BufIdx, EthSwt_MgmtInfoType* MgmtInfo);
EthIf_SwitchGetCfgDataInfo دالة

Retrieves the total size of data and the memory start address of the indexed Ethernet Switch.

Std_ReturnType EthIf_SwitchGetCfgDataInfo (uint8 SwitchIdx, uint32* DataSizePtr, uint32* DataAdressPtr);
EthIf_SwitchGetCfgDataRaw دالة

Retrieves the data in memory of the indexed Ethernet switch in variable length

Std_ReturnType EthIf_SwitchGetCfgDataRaw (uint8 SwitchIdx, uint32 Offset, uint16 Length, uint8* BufferPtr);
EthIf_SwitchPortGetBaudRate دالة

Obtains the baud rate of the indexed switch port

Std_ReturnType EthIf_SwitchPortGetBaudRate (thernetInterface uint8 SwitchIdx, uint8 SwitchPortIdx, EthTrcv_BaudRateType* BaudRatePtr); ⚠️
EthIf_SwitchPortGetCounterValues دالة

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.

Std_ReturnType EthIf_SwitchPortGetCounterValues (uint8 SwitchIdx, thernetInterface uint8 SwitchPortIdx, Eth_CounterType* CounterPtr); ⚠️
EthIf_SwitchPortGetDuplexMode دالة

Obtains the duplex mode of the indexed switch port

Std_ReturnType EthIf_SwitchPortGetDuplexMode (uint8 SwitchIdx, uint8 SwitchPortIdx, EthTrcv_DuplexModeType* DuplexModePtr);
EthIf_SwitchPortGetLinkState دالة

Obtains the link state of the indexed switch port

Std_ReturnType EthIf_SwitchPortGetLinkState (uint8 SwitchIdx, uint8 SwitchPortIdx, EthTrcv_LinkStateType* LinkStatePtr);
EthIf_SwitchPortGetMacLearningMode دالة

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

Std_ReturnType EthIf_SwitchPortGetMacLearningMode (thernetInterface uint8 SwitchIdx, uint8 SwitchPortIdx, EthSwt_MacLearningType* MacLearningModePtr); ⚠️
EthIf_SwitchPortGetMaxFIFOBufferFillLevel دالة

Service EthIf_SwitchPortGetMaxFIFOBufferFillLevel.

Std_ReturnType EthIf_SwitchPortGetMaxFIFOBufferFillLevel (uint8 SwitchPortIdx, uint8 PortIdx, uint8 SwitchPortEgressFifoIdx, uint32* SwitchPortEgressFifoBufferLevelPtr);
EthIf_SwitchPortGetRxStats دالة

Returns a list of statistic counters defined with E th_ Rx Tats Type. The majority of these Counters are derived from the IETF RFC2819.

Std_ReturnType EthIf_SwitchPortGetRxStats (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_RxStatsType* RxStatsPtr);
EthIf_SwitchPortGetTxErrorCounterValues دالة

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.

Std_ReturnType EthIf_SwitchPortGetTxErrorCounterValues (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_TxErrorCounterValuesType* TxStatsPtr);
EthIf_SwitchPortGetTxStats دالة

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.

Std_ReturnType EthIf_SwitchPortGetTxStats (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_TxStatsType* TxStatsPtr);
EthIf_SwitchPortGroupRequestMode دالة

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.

Std_ReturnType EthIf_SwitchPortGroupRequestMode (EthIf_SwitchPortGroupIdxType PortGroupIdx, Eth_ModeType PortMode);
EthIf_SwitchPortModeIndication دالة

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()

void EthIf_SwitchPortModeIndication (uint8 SwitchIdx, uint8 SwitchPortIdx, Eth_ModeType PortMode);

الخدمات · Transceiver…

EthIf_TransceiverGetBaudRate دالة

Obtains the baud rate of the indexed transceiver

Std_ReturnType EthIf_TransceiverGetBaudRate (uint8 TrcvIdx, EthTrcv_BaudRateType* BaudRatePtr);
EthIf_TransceiverGetDuplexMode دالة

Obtains the duplex mode of the indexed tra nsceiver

Std_ReturnType EthIf_TransceiverGetDuplexMode (uint8 TrcvIdx, EthTrcv_DuplexModeType* DuplexModePtr);
EthIf_TransceiverGetLinkState دالة

Obta ins the link state of the indexed transceiver

Std_ReturnType EthIf_TransceiverGetLinkState (uint8 TrcvIdx, EthTrcv_LinkStateType* LinkStatePtr);
EthIf_TransceiverGetMacMethod دالة

Obtains the media access mode of the transceiver. Tags: atp.Status=draft thernet Interface AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_EthernetInterface

Std_ReturnType EthIf_TransceiverGetMacMethod (uint8* TrcvIdx, EthTrcv_MacMethodType* MacModePtr);

الخدمات · أخرى

EthIf_CheckWakeup دالة

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.

Std_ReturnType EthIf_CheckWakeup (EcuM_WakeupSourceType WakeupSource);
EthIf_ClearSwitchPortSignalQuality دالة

Clear the stored signal quality of the link of the given Et hernet switch port

Std_ReturnType EthIf_ClearSwitchPortSignalQuality (uint8 SwitchIdx, uint8 SwitchPortIdx);
EthIf_ClearTrcvSignalQuality دالة

Clear the stored signal quality of the link of the given Ethernet transceiver

Std_ReturnType EthIf_ClearTrcvSignalQuality (uint8 TrcvIdx);
EthIf_CtrlModeIndication دالة

Called asynchronously when mode has been read out. Triggered by previous Eth_ Set Controller Mode call. Can directly be called within the trigger functions.

void EthIf_CtrlModeIndication (uint8 CtrlIdx, thernetInterface Eth_ModeType CtrlMode); ⚠️
EthIf_DeletePortMirrorConfiguration دالة

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.

Std_ReturnType EthIf_DeletePortMirrorConfiguration (uint8 MirroredSwitchIdx);
EthIf_EnableEgressTimeStamp دالة

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.

void EthIf_EnableEgressTimeStamp (uint8 CtrlIdx, Eth_BufIdxType BufIdx thernetInterface); ⚠️
EthIf_ProvideTxBuffer دالة

Provides access to a transmit buffer of the specified Ethernet controller.

BufReq_ReturnType EthIf_ProvideTxBuffer (uint8 CtrlIdx, Eth_FrameType FrameType, uint8 Priority, Eth_BufIdxType* BufIdxPtr, uint8* * BufPtr, uint16* LenBytePtr);
EthIf_ReadPortMirrorConfiguration دالة

Obtain the port mirror configuration of the given Ethernet switch.

Std_ReturnType EthIf_ReadPortMirrorConfiguration (uint8 MirroredSwitchIdx, EthSwt_PortMirrorCfgType* PortMirrorConfigurationPtr);
EthIf_ResetConfiguration دالة

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.

Std_ReturnType EthIf_ResetConfiguration (uint8 SwitchIdx);
EthIf_RunCableDiagnostic دالة

Trigger the cable diagnostics for the given Ethernet transceiver.

Std_ReturnType EthIf_RunCableDiagnostic (uint8 TrcvIdx);
EthIf_RunPortCableDiagnostic دالة

Trigger the cable diagnostics of the given Ethernet Switch port (Port Idx) by calling Eth Trcv_ Run Cable Diagnostic of the referenced Ethernet transceiver.

Std_ReturnType EthIf_RunPortCableDiagnostic (uint8 SwitchIdx, uint8 PortIdx);
EthIf_SleepIndication دالة

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

void EthIf_SleepIndication (uint8 TrcvIdx);
EthIf_StartAllPorts دالة

Request to set all configured and affected Eth Swt Ports to ETH_ MODE_ ACTIVE

Std_ReturnType EthIf_StartAllPorts (void);
EthIf_StoreConfiguration دالة

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.

Std_ReturnType EthIf_StoreConfiguration (uint8 SwitchIdx);
EthIf_Transmit دالة

Triggers transmission of a previously filled transmit buffer

Std_ReturnType EthIf_Transmit (uint8 CtrlIdx, Eth_BufIdxType BufIdx, Eth_FrameType FrameType, boolean TxConfirmation, uint16 LenByte, const uint8* PhysAddrPtr);
EthIf_TrcvModeIndication دالة

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

void EthIf_TrcvModeIndication (uint8 TrcvIdx, Eth_ModeType TrcvMode);
EthIf_UpdatePhysAddrFilter دالة

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.

Std_ReturnType EthIf_UpdatePhysAddrFilter (uint8 CtrlIdx, const uint8* PhysAddrPtr, Eth_FilterActionType Action);
EthIf_VerifyConfig دالة

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.

Std_ReturnType EthIf_VerifyConfig (uint8 SwitchIdx, boolean* Result);
EthIf_WritePortMirrorConfiguration دالة

Service EthIf_WritePortMirrorConfiguration.

Std_ReturnType EthIf_WritePortMirrorConfiguration (uint8 MirroredSwitchIdx, const EthSwt_PortMirrorCfgType* PortMirrorConfigurationPtr);

دوال الاستدعاء الراجع

EthIf_RxIndication دالة

Handles a received frame received by the indexed controller

void EthIf_RxIndication (uint8 CtrlIdx, Eth_FrameType FrameType, boolean IsBroadcast, const uint8* PhysAddrPtr, const Eth_DataType* DataPtr, uint16 LenByte);
EthIf_TxConfirmation دالة

Confirms frame transmission by the indexed controller

void EthIf_TxConfirmation (uint8 CtrlIdx, Eth_BufIdxType BufIdx, Std_ReturnType Result);

دورية

EthIf_MainFunctionRx دالة

The function checks for new received frames and issues reception indications in polling mode.

void EthIf_MainFunctionRx (void);
EthIf_MainFunctionState دالة

The function is polling different communication hardware (Ethernet transceiver, Ethernet switch ports) related information, e.g. link state, signal quality.

void EthIf_MainFunctionState (void);
EthIf_MainFunctionTx دالة

The function issues transmission confirmations in polling mode. It checks also for transceiver state changes.

void EthIf_MainFunctionTx (void);

الأنواع

EthIf_ConfigType نوع

Implementation specific structure of the post build configuration

EthIf_MeasurementIdxType نوع

Index to select specific measurement data

EthIf_SwitchPortGroupIdxType نوع

Data Type that represents the Ethernet interface switch port group index. The index is zero based and unique for every configured switch port group.