FlexRay Transceiver Driver (FrTrcv)

يتحكم مشغل جهاز الإرسال والاستقبال FlexRay في مكونات أجهزة الإرسال والاستقبال الخاصة بوحدة التحكم الإلكترونية ECU عبر Dio أو Spi ويوفر في ACTIVE الأوضاع NORMAL وRECEIVEONLY وSTANDBY وSLEEP [SWS_FrTrcv_00481]. ويقوم بضبط الأوضاع وقراءتها، ويكتشف أحداث الاستيقاظ عبر الاستقصاء الدوري أو الإشعار، ويبلغ عنها إلى EcuM ويقدم سبب الاستيقاظ. في النجوم النشطة، يستعلم عن أخطاء الناقل لكل فرع ويقوم بفصل الفروع أو توصيلها. وإذا فشل تغيير الوضع، فإنه يعيد E_NOT_OK ويترك الحالة السابقة دون تغيير [SWS_FrTrcv_00323].

المزيد ›

يتحكم مشغل جهاز الإرسال والاستقبال FlexRay في مكونات أجهزة الإرسال والاستقبال الخاصة بـ ECU. ويقوم بعنونة كل مكوّن عبر الفهرس ذي الأساس الصفري FrTrcv_TrcvIdx [SWS_FrTrcv_00323]. ومن الناحية السفلية، يصل إلى الأجهزة اعتماداً على التكوين عبر Dio أو Spi SWS FrTrcv الشكل 10.4 ص. 77. بالإضافة إلى ذلك، يستخدم Icu وEcuM وDem وDet [SWS_FrTrcv_00334]. ومن الناحية العلوية، يُرجح أن FrIf يستخدم الخدمات في المقام الأول نيابة عن FlexRay State Manager (تفسير) SWS FrSM ص. 20. سؤال (مفتوح)

مخطط السياق: FrTrcv بين FrIf/FrSM، ومشغلات الأجهزة، والخدمات EcuM وDEM وDET. المصادر: [SWS_FrTrcv_00334]، SWS FrSM ص. 20

بعد التشغيل، يكون المشغل في NOT_ACTIVE وينتقل عبر FrTrcv_Init إلى ACTIVE SWS FrTrcv الشكل 7.1 ص. 23. وهناك تسري الأوضاع NORMAL وRECEIVEONLY وSTANDBY وSLEEP [SWS_FrTrcv_00481]. ويقوم FrTrcv_SetTransceiverMode بالتبديل بينها. إذا فشل التبديل، تقدم الخدمة E_NOT_OK وتترك الحالة القديمة قائمة. ينفذ المشغل فترات الانتظار باستخدام Tm_BusyWait1us16bit [SWS_FrTrcv_00485]. في STANDBY، تكون قنوات الاستيقاظ لـ ICU مُمكَّنة، وفي NORMAL تكون معطلة [SWS_FrTrcv_00491] [SWS_FrTrcv_00492].

مخطط الحالة: لا يمكن الوصول إلى أوضاع ACTIVE الأربعة إلا بعد FrTrcv_Init. تمت إعادة بناء المسارات جزئياً (تفسير). المصادر: SWS FrTrcv الشكل 7.1 ص. 23، [SWS_FrTrcv_00481]

يكتشف المشغل أحداث الاستيقاظ بطريقتين: عبر FrTrcv_MainFunction الدورية [SWS_FrTrcv_00330] أو عبر الإشعار. بعد FrTrcv_CheckWakeupByTransceiver، يبلغ عن الحدث إلى EcuM SWS FrTrcv ص. 46. ويقدم FrTrcv_GetTransceiverWUReason السبب، مثل FRTRCV_WU_BY_BUS، بقدر ما تستطيع الأجهزة تمييزه [SWS_FrTrcv_00074]. ويمسح FrTrcv_ClearTransceiverWakeup جميع الأحداث المعلقة [SWS_FrTrcv_00329].

في النجوم النشطة، تستعلم خدمات اختيارية عن أخطاء الناقل لكل فرع وتقوم بفصل الفروع أو إعادة توصيلها [SWS_FrTrcv_00419] [SWS_FrTrcv_00442] [SWS_FrTrcv_00443]. بالنسبة لمعالجة الأخطاء، يسري ما يلي:

• تذهب أخطاء التطوير مثل FRTRCV_E_UNINIT إلى DET [SWS_FrTrcv_00085].
• تمر أخطاء وقت التشغيل مثل FRTRCV_E_FR_NO_CONTROL_TRCV عبر Det_ReportRuntimeError [SWS_FrTrcv_91001].
• يبلغ المشغل عن أخطاء الناقل من الفئتين A وB إلى DEM أو إلى وظيفة بديلة تم تكوينها [SWS_FrTrcv_00475].

المزيد ›

الدور: تجريد الأجهزة لمكونات جهاز الإرسال والاستقبال FlexRay

يتحكم مشغل جهاز الإرسال والاستقبال FlexRay في مكون واحد أو أكثر من مكونات جهاز الإرسال والاستقبال FlexRay التابعة لـ ECU. تختار جميع الخدمات المرتبطة بالقنوات المكون عبر الفهرس ذي الأساس الصفري FrTrcv_TrcvIdx، والذي يسري في سياق المشغل [SWS_FrTrcv_00323]. يقدم المشغل ثلاث مجموعات من الخدمات:

• ضبط أوضاع التشغيل والاستعلام عنها [SWS_FrTrcv_00324]،
• معالجة أحداث الاستيقاظ [SWS_FrTrcv_00325] [SWS_FrTrcv_00331]،
• في النجوم النشطة، إدارة الفروع الفردية [SWS_FrTrcv_00419].

يقدم FrTrcv_GetVersionInfo صراحةً إصدار وحدة البرمجيات وليس إصدار أجهزة جهاز الإرسال والاستقبال SWS FrTrcv ص. 43.

من الناحية السفلية، يصل المشغل إلى المكون عبر Dio أو Spi. لإشعارات الاستيقاظ، يستخدم Icu، وتذهب البلاغات إلى EcuM وDem وDet [SWS_FrTrcv_00334] [SWS_FrTrcv_00321]. وتحدد حاوية الاختيار FrTrcvAccess نوع الوصول: حيث تسمح بواحد فقط من البديلين، أي الوصول عبر Dio أو تسلسل SPI SWS FrTrcv الشكل 10.4 ص. 77.

من الناحية العلوية، يُرجح أن واجهة FlexRay تستخدم الخدمات في المقام الأول. يحدد FlexRay State Manager سبب الاستيقاظ لكل جهاز إرسال واستقبال في الكتلة عبر FrIf_GetTransceiverWUReason SWS FrSM ص. 20. تفسير: يمرر FrIf هذه الطلبات إلى FrTrcv. سؤال Q-29229b532631a6b5 (مفتوح) ويتطابق مع ذلك حقيقة أن الأنواع المشتركة في Fr_GeneralTypes.h محمية بواسطة FR_GENERAL_TYPES، حتى يتمكن العديد من مشغلات أجهزة الإرسال والاستقبال وFrIf من مشاركتها SWS FrTrcv ص. 34.

مخطط السياق: يقع FrTrcv بين FrIf/FrSM والمشغلات Dio وSpi وIcu ويبلغ إلى EcuM وDEM وDET. المصادر: [SWS_FrTrcv_00334]، [SWS_FrTrcv_00485]، [SWS_FrTrcv_00330]، SWS FrSM ص. 20

أوضاع التشغيل بين NOT_ACTIVE وACTIVE

يصف الشكل 7.1 من المواصفات الأوضاع كآلة حالة متداخلة. ضمن POWER_ON، يكون المشغل بعد التشغيل في NOT_ACTIVE وينتقل عبر FrTrcv_Init() إلى ACTIVE SWS FrTrcv الشكل 7.1 ص. 23. وتسري القيم الأربع لـ FrTrcv_TrcvModeType فقط في ACTIVE: وهي FRTRCV_TRCVMODE_NORMAL وFRTRCV_TRCVMODE_RECEIVEONLY وFRTRCV_TRCVMODE_STANDBY وFRTRCV_TRCVMODE_SLEEP [SWS_FrTrcv_00481]. وتقوم الطبقة المستدعية بالتبديل بين هذه الأوضاع باستخدام FrTrcv_SetTransceiverMode [SWS_FrTrcv_00323].

تتم عملية تغيير الوضع بشكل متزامن وغير قابلة لإعادة الدخول. ويُسمح بفشل الانتقالات إلى الحالات الاختيارية. في هذه الحالة، تقدم الخدمة E_NOT_OK، وتظل الحالة السابقة محفوظة SWS FrTrcv ص. 39. إذا احتاج المكون إلى فترات انتظار لتغيير الحالة، ينفذها المشغل باستخدام خدمة التوقيت Tm_BusyWait1us16bit [SWS_FrTrcv_00485]. ويقرأ FrTrcv_GetTransceiverMode الحالة الفعلية. هذه الخدمة قابلة لإعادة الدخول وبالتالي يمكن استدعاؤها أيضاً بشكل متوازٍ [SWS_FrTrcv_00324].

مخطط الحالة: لا يمكن الوصول إلى أوضاع ACTIVE الأربعة عبر FrTrcv_SetTransceiverMode إلا بعد FrTrcv_Init. تم اختيار المسارات بشكل معاد بناؤه جزئياً (تفسير). المصادر: SWS FrTrcv الشكل 7.1 ص. 23، [SWS_FrTrcv_00481]

بدء التشغيل وبدء اتصال الناقل

يتلقى FrTrcv_Init مؤشراً إلى مجموعة التكوين المحددة ويقوم بتهيئة المشغل [SWS_FrTrcv_00322]. تقوم هذه الدالة المنفصلة بتهيئة المتغيرات وموارد الأجهزة. وتتم إعادة تهيئة المشغلات التي تخدم مصادر الاستيقاظ في كتلة Restart، مما يعيد تفعيل آلية إطلاق بلاغ الاستيقاظ SWS FrTrcv ص. 37. يدعم المشغل تسلسل تهيئة حزمة AUTOSAR. تفسير: يُرجح أن ECU State Manager يستدعي الدالة ضمن هذا التسلسل. سؤال Q-93ce1e5987a96873 (مفتوح)

يؤثر الانتقال إلى NORMAL على مسارات الاستيقاظ. إذا تم تكوين FrTrcvIcuChannelRef، يقوم المشغل بتعطيل قنوات ICU باستخدام Icu_DisableNotification [SWS_FrTrcv_00492]. وبدون هذا المرجع، لا يصل إطلاقاً إلى قنوات ICU [SWS_FrTrcv_00490].

مخطط التسلسل: تلي التهيئةَ الانتقالُ إلى NORMAL مع الانتظار النشط (busy-wait) والتعطيل الاختياري لـ ICU. ويترك الفشلُ الحالةَ دون تغيير. المصادر: [SWS_FrTrcv_00322]، [SWS_FrTrcv_00323]، [SWS_FrTrcv_00485]، [SWS_FrTrcv_00492]

اكتشاف الاستيقاظ في STANDBY وSLEEP، وسبب الاستيقاظ

عند الانتقال إلى STANDBY، يعيد المشغل تمكين قنوات ICU [SWS_FrTrcv_00491]. بالإضافة إلى ذلك، يمسح FrTrcv_SetTransceiverMode سجل الأخطاء في جهاز الإرسال والاستقبال عند كل انتقال إلى STANDBY، شريطة أن تدعم الأجهزة ذلك SWS FrTrcv ص. 39.

بالإضافة إلى ذلك، يمكن للمشغل إجراء الاستقصاء بشكل دوري. ولهذا الغرض، يوفر FrTrcv_MainFunction عبر SchM_FrTrcv.h [SWS_FrTrcv_00330]. وفقاً للفقرة المرجعية من R23-11، تبحث الدالة في جميع النواقل في STANDBY وSLEEP عن أحداث الاستيقاظ وتخزن الأحداث التي تم العثور عليها داخلياً. ويحدد التكوين الفترة الزمنية. ويجوز أن تعمل الدالة بشكل متزامن أو غير متزامن مع جدول ناقل FlexRay SWS FrTrcv ص. 49.

مخطط التسلسل: عند الانتقال إلى STANDBY، يتم مسح سجل الأخطاء وتمكين إشعار ICU. بعد ذلك، تبحث Main Function بشكل دوري عن أحداث الاستيقاظ. المصادر: [SWS_FrTrcv_00491]، [SWS_FrTrcv_00330]، SWS FrTrcv ص. 49

إذا اكتشف المكون استيقاظاً عبر الناقل، يُخطر جانب SPI أو DIO التابع المشغلَ. ويمكن أن يحدث ذلك في سياق المقاطعة SWS FrTrcv ص. 46. إذا تم استدعاء FrTrcv_CheckWakeupByTransceiver بعد ذلك [SWS_FrTrcv_00331]، يبلغ المشغل عن الحدث إلى ECU State Manager. ولهذا الغرض، تظهر EcuM_SetWakeupEvent في قائمة الواجهات المستخدمة [SWS_FrTrcv_00334]. تفسير: يُرجح أن EcuM يبدأ استدعاء الفحص في تسلسل الاستيقاظ الخاص به. سؤال Q-d5873691a495bef0 (مفتوح)

يقدم FrTrcv_GetTransceiverWUReason [SWS_FrTrcv_00325] سبب الاستيقاظ كقيمة لـ FrTrcv_TrcvWUReasonType. القيم الممكنة هي FRTRCV_WU_BY_BUS أو FRTRCV_WU_BY_PIN أو FRTRCV_WU_INTERNALLY أو FRTRCV_WU_NOT_SUPPORTED [SWS_FrTrcv_00074]. ويعتمد مدى دقة التمييز بين الأسباب اعتماداً كبيراً على الأجهزة SWS FrTrcv ص. 42. تذكر الفقرة المرجعية من الإصدارات اللاحقة بالإضافة إلى ذلك FRTRCV_WU_RESET وFRTRCV_WU_POWER_ON SWS FrTrcv ص. 34. تم اختصار نص متطلبات R20-11 في الحمولة في هذه النقطة.

يفحص FrSM سبب الاستيقاظ لكل جهاز إرسال واستقبال بحثاً عن FRTRCV_WU_BY_BUS. وهكذا يميز ما إذا كان لا يوجد استيقاظ للناقل، أو استيقاظ جزئي، أو استيقاظ كامل SWS FrSM ص. 20. بعد ذلك، يمسح FrTrcv_ClearTransceiverWakeup جميع أحداث الاستيقاظ المعلقة [SWS_FrTrcv_00329]. الاستدعاء مسموح به أيضاً حتى لو تم تعطيل إشعار الاستيقاظ SWS FrTrcv ص. 44.

مخطط التسلسل: التسلسل بدءاً من إشعار الأجهزة مروراً ببلاغ EcuM وحتى الاستعلام عن سبب الاستيقاظ ومسحه. لا تذكر الحمولة مستدعي دالة الفحص (تفسير). المصادر: [SWS_FrTrcv_00331]، [SWS_FrTrcv_00325]، [SWS_FrTrcv_00329]، SWS FrTrcv ص. 46

النجوم النشطة: مراقبة الفروع وفصلها وتمكينها

بالنسبة لأجهزة الإرسال والاستقبال التي تخدم عدة فروع كنجمة نشطة، توجد ثلاث خدمات إضافية. وهي متاحة فقط إذا تم تكوين الفروع SWS FrTrcv ص. 52. تقوم الثلاث جميعها بعنونة الفرع بشكل إضافي عبر الفهرس ذي الأساس الصفري FrTrcv_BranchIdx وهي غير قابلة لإعادة الدخول [SWS_FrTrcv_00419] [SWS_FrTrcv_00442] [SWS_FrTrcv_00443].

يكتب FrTrcv_GetTransceiverError حالة الخطأ لفرع كـ uint32 في FrTrcv_BusErrorState. يمكن الاستعلام عن جميع الأخطاء المنصوص عليها في FlexRay EPL والتي تدعمها الأجهزة SWS FrTrcv ص. 48. يتم فصل الفروع المعيبة باستخدام FrTrcv_DisableTransceiverBranch SWS FrTrcv ص. 50. ويعيد FrTrcv_EnableTransceiverBranch تمكينها بشكل متزامن مع جدول ناقل FlexRay SWS FrTrcv ص. 51. وإذا كان الفهرس يقع خارج النطاق الصالح، تقدم كلتا خدمتي التبديل E_NOT_OK، وتظل حالة الفرع دون تغيير [SWS_FrTrcv_00442] [SWS_FrTrcv_00443].

مخطط النشاط: الاستعلام عن الأخطاء لكل فرع، وفصل الفروع المعيبة، وإعادة التمكين بالتزامن مع جدول الناقل. يُعتبر اتخاذ الطبقة المستدعية للقرار تفسيراً. المصادر: [SWS_FrTrcv_00419]، SWS FrTrcv ص. 50، SWS FrTrcv ص. 51

التكوين، ونوع الوصول، والتقسيم

FrTrcv_ConfigType هو هيكل خاص بالتنفيذ [SWS_FrTrcv_00487]. تحتوي الوحدة على حاوية واحدة أو أكثر من FrTrcvChannel، واحدة لكل قناة جهاز إرسال واستقبال، بالإضافة إلى FrTrcvGeneral SWS FrTrcv ص. 59. بالإضافة إلى ذلك، تذكر هذه الفقرة المرجعية من R23-11/R25-11 فقط VARIANT-PRE-COMPILE دون دعم Post-Build. بالنسبة لـ R20-11، لا تحتوي الحمولة على متطلب بهذا الشأن.

لكل جهاز إرسال واستقبال (Transceiver)، يختار FrTrcvAccess إما FrTrcvDioAccess أو FrTrcvSpiSequence SWS FrTrcv الشكل 10.4 ص. 77. يمكن تمكين الوظائف الاختيارية وتعطيلها في وقت الترجمة SWS FrTrcv ص. 52. يربط FrTrcvIcuChannelRef إشعار التنبيه الخاص بـ ICU بـ [SWS_FrTrcv_00490]. باستخدام FrTrcvDemReportErrorStatusConfiguration، يمكن استخدام وظيفة مخصصة ذات التوقيع نفسه بدلاً من Dem_SetEventStatus [SWS_FrTrcv_00475].

في الأنظمة المقسمة إلى أجزاء (Partitioned systems)، تعمل الوحدة كنسخة مستقلة لكل قسم. يؤثر استدعاء API فقط على القسم الذي يتم فيه الاستدعاء [SWS_FrTrcv_00494]. يجب على الوحدة رفض تعيينات الأقسام التي لا يدعمها التنفيذ [SWS_FrTrcv_00497].

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

أخطاء التطوير محددة [SWS_FrTrcv_00085]:

• FRTRCV_E_FR_INVALID_TRCVIDX (0x01),
• FRTRCV_E_FR_INVALID_BRANCHIDX (0x02),
• FRTRCV_E_UNINIT (0x10),
• FRTRCV_E_PARAM_POINTER (0x15).

يتم الإبلاغ عنها فقط عند تفعيل خاصية اكتشاف أخطاء التطوير. من الأمثلة على ذلك FRTRCV_E_UNINIT في خدمات الفروع SWS FrTrcv ص. 50 ومؤشر NULL عند FrTrcv_GetVersionInfo SWS FrTrcv ص. 43.

كخطأ في وقت التشغيل، يبلغ برنامج التشغيل عن الاستدعاءات في الوضع غير الصحيح عبر FRTRCV_E_FR_TRCV_NOT_STANDBY إلى FRTRCV_E_FR_TRCV_NOT_RECEIVEONLY (من 0x11 إلى 0x14). ويبلغ عن فقدان الاتصال بالمكون أو حدوث خلل فيه عبر FRTRCV_E_FR_NO_CONTROL_TRCV (0x16) [SWS_FrTrcv_91001]. تمر هذه البلاغات عبر Det_ReportRuntimeError [SWS_FrTrcv_00493]. يطلق FrTrcv_GetTransceiverMode الخطأ FRTRCV_E_FR_NO_CONTROL_TRCV عند حدوث خطأ في الوصول إلى جهاز الإرسال والاستقبال مثلاً SWS FrTrcv ص. 41.

عند E_NOT_OK تظل معلمات الإخراج دون تغيير، كما هو الحال مع FrTrcv_GetTransceiverMode وFrTrcv_GetTransceiverError SWS FrTrcv ص. 48. يؤدي فشل تغيير الوضع إلى الإبقاء على الحالة السابقة [SWS_FrTrcv_00323].

مخطط النشاط: تؤدي فحوصات المعلمات والتهيئة إلى أخطاء تطوير، بينما تؤدي أخطاء الوصول إلى خطأ في وقت التشغيل. يُعد ترتيب الفحوصات مجرد تفسير. لا تتوفر فحوصات DET إلا عند تفعيل اكتشاف الأخطاء. المصادر: [SWS_FrTrcv_00085]، [SWS_FrTrcv_91001]، [SWS_FrTrcv_00493]

لأغراض تشخيص الإنتاج، يميّز برنامج التشغيل بين فئتين من أجهزة الإرسال والاستقبال:

• في أجهزة الإرسال والاستقبال من الفئة A التي يتم التحكم فيها عبر GPIO، يعني طرف ERRN النشط (low) «Fail»، بينما يعني الطرف غير النشط (high) «Pass» [SWS_FrTrcv_00489].
• في أجهزة الإرسال والاستقبال من الفئة B التي يتم التحكم فيها عبر SPI، تطلق كل بتة مضبوطة 1…9 خطأً في ناقل الاتصال [SWS_FrTrcv_00488].

يتم التقييم عند حدوث HALT غير متوقع أو عند NORMAL_ACTIVE لوحدة التحكم. في حال حدوث تماس كهربائي على ناقل الاتصال، لا تكفي نتيجة «Pass» لبرنامج التشغيل بمفردها كدليل SWS FrTrcv ص. 26. يتوفر Dem_SetEventStatus فقط مع STANDARD_REPORTING [SWS_FrTrcv_00334].

مخطط النشاط: تقييم Pass/Fail لكل فئة جهاز إرسال واستقبال ومسار الإبلاغ إلى DEM أو إلى الوظيفة البديلة التي تم تكوينها. المصادر: [SWS_FrTrcv_00488]، [SWS_FrTrcv_00489]، [SWS_FrTrcv_00475]

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

المرجع	التصنيف
[SWS_FrTrcv_00481], SWS FrTrcv Abb. 7.1 S. 23	أوضاع التشغيل وآلة الحالات
[SWS_FrTrcv_00323], SWS FrTrcv S. 39	تغيير الوضع، الفشل، ومسح سجل الأخطاء في STANDBY
[SWS_FrTrcv_00322], SWS FrTrcv S. 37	التهيئة وقاعدة إعادة التشغيل لمصادر التنبيه
[SWS_FrTrcv_00330], [SWS_FrTrcv_00485]	الاستقصاء الدوري وأوقات الانتظار
[SWS_FrTrcv_00331], [SWS_FrTrcv_00325], [SWS_FrTrcv_00074], [SWS_FrTrcv_00329]	مسار التنبيه من الاكتشاف حتى المسح
[SWS_FrTrcv_00490], [SWS_FrTrcv_00491], [SWS_FrTrcv_00492]	إشعار ICU بالاعتماد على الوضع
[SWS_FrTrcv_00419], [SWS_FrTrcv_00442], [SWS_FrTrcv_00443]	إدارة الفروع في الهياكل النجمية النشطة
[SWS_FrTrcv_00085], [SWS_FrTrcv_91001], [SWS_FrTrcv_00493]	أخطاء التطوير وأخطاء وقت التشغيل
[SWS_FrTrcv_00488], [SWS_FrTrcv_00489], [SWS_FrTrcv_00475]	أحداث DEM ومسار الإبلاغ
[SWS_FrTrcv_00487], [SWS_FrTrcv_00494], [SWS_FrTrcv_00497]	نوع التكوين وتقسيم الأقسام