Diagnostic Communication Manager (DCM)

تُستخدم الدالة المتزامنة وغير القابلة لإعادة الدخول Dcm_Init للتهيئة الأساسية لوحدة DCM [SWS_Dcm_00037]. تستقبل عبر المعلمة ConfigPtr مؤشرًا إلى مجموعة التكوين في متغيرات ما بعد البناء (Post-Build) وليس لها قيمة إرجاع [SWS_Dcm_00037]. أثناء التنفيذ، تهيئ الوحدة جميع متغيرات DCM العامة بالقيم المستمدة من التكوين [SWS_Dcm_00334].

في إطار تسلسل التهيئة، يتم تكوين نطاقات وظيفية وحالات مختلفة:

• إدارة DDDID: إذا تم ضبط معلمة التكوين DcmDDDIDStorage إلى FALSE، فإن DCM يهيئ عند بدء التشغيل جميع معرّفات البيانات المعرفة ديناميكيًا (DDDIDs) كغير موجودة [SWS_Dcm_00866]. وإذا تم ضبط المعلمة إلى TRUE، تتم استعادة تعريفات DDDID من NvM [SWS_Dcm_00867].
• الاستجابة عند وقوع حدث (ROE): ينقل DCM حالة كل حدث أثناء Dcm_Init إلى الحالة 'ROE cleared' [SWS_Dcm_00872].
• حالة المصادقة: إذا لم يتم تكوين DcmDspAuthenticationPersistStateModeRuleRef أو تم تقييم قاعدة الوضع المشار إليها إلى false، تنقل الوحدة جميع حالات المصادقة إلى الحالة 'deauthenticated' [SWS_Dcm_01480].
• حالة الاتصال: بعد اكتمال Dcm_Init، يضبط DCM المعلمة ActiveDiagnostic إلى 'DCM_COMM_ACTIVE' [SWS_Dcm_01069].

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

الاستخدام

الواجهة المتزامنة Dcm_DemTriggerOnDTCStatus (معرّف الخدمة 0x2B) متاحة عبر ملف الترويسة Dcm_Dem.h وتُستخدم للإبلاغ عن تغييرات بايت حالة UDS إلى DCM [SWS_Dcm_00614]. يتيح ذلك لـ DCM إطلاق أحداث الاستجابة عند الحدث (ROE) للخدمة الفرعية لخدمة التشخيص OnDTCStatusChanged [SWS_Dcm_00614]. وعند الاستدعاء، تستقبل الدالة ثلاثة معاملات إدخال: كود العطل المتأثر DTC (uint32)، والحالة السابقة DTCStatusOld (Dem_UdsStatusByteType) بالإضافة إلى الحالة المحدثة DTCStatusNew (Dem_UdsStatusByteType) [SWS_Dcm_00614]. ولا توجد معاملات إدخال وإخراج مشتركة [SWS_Dcm_00614].

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

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

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

تم تصنيف الدالة على أنها قابلة لإعادة الدخول وتتميز بدلالات تنفيذ متزامنة [SWS_Dcm_00614]. وفيما يتعلق بالتفاعل مع طلبات التشخيص، ينطبق شرط حدي ثابت: إذا كان DCM يعالج حاليًا طلبًا لمسح ذاكرة الأحداث (EventMemory)، فيجب على DCM تجاهل الاستدعاءات الواردة لرد النداء Dcm_DemTriggerOnDTCStatus [SWS_Dcm_01410].

تُستخدم الدالة Dcm_BndMWriteBlockFinish كواجهة إشعار من BndM إلى DCM للإشارة إلى اكتمال عملية كتابة كتلة [SWS_Dcm_91088]. الدالة مصرح عنها في ملف الرأس Dcm.h، ولها معرّف الخدمة (Service ID) 0x7a، ولا تُرجع أي قيمة (void)، ويتم تنفيذها بشكل متزامن [SWS_Dcm_91088].

تتوقع الواجهة معاملي تمرير [SWS_Dcm_91088]:

• BlockId (النوع: BndM_BlockIdType): يحدد الكتلة التي اكتملت عملية كتابتها.
• result (النوع: BndM_ResultType): ينقل نتيجة عملية الكتابة إلى DCM.

يرتبط التفاعل الوظيفي والسلوك في حالة الخطأ بعمليات كتابة BndM الذرية التي تم تشغيلها مسبقاً بواسطة DCM:

• إذا تم استدعاء Dcm_BndMWriteBlockFinish بالحالة result = E_OK، يُرسل DCM استجابة تشخيصية إيجابية على الطلب المعلق [SWS_Dcm_01584].
• إذا تم استدعاء الدالة بـ result = E_NOT_OK، يستجيب DCM في حالة الخطأ باستجابة تشخيصية سلبية 0x72 (generalProgrammingFailure) [SWS_Dcm_01585].

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

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

تُنفذ الدالة Dcm_SetDeauthenticatedRole بشكل متزامن وقابل لإعادة الدخول ([SWS_Dcm_91069]). وهي تتيح لمكون برمجي تعيين دور جديد deauthenticatedRole من النوع Dcm_AuthenticationRoleType لاتصال محدد بواسطة connectionId للحالة غير الموثقة ([SWS_Dcm_91069]، [SWS_Dcm_01486]). يتم إرجاع E_OK كقيمة مرجعة دون استثناء ([SWS_Dcm_91069]).

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

تتم معالجة الاستدعاء بواسطة DCM فقط إذا كان الاتصال في الحالة غير الموثقة (deauthenticated state) ([SWS_Dcm_01487]). نظراً لأن التوقيع لا ينص على قيم أخطاء بديلة ويعيد دائماً E_OK ([SWS_Dcm_91069])، فمن المحتمل أن يتم رفض أي استدعاء خارج هذه الحالة دون رسالة خطأ. سؤال Q-6f14770eae6ce896 (مفتوح) لم يتم تحديد أحداث DET أو DEM معينة في المواصفة.

فترة الصلاحية ودورة الحياة

إذا تم اعتماد الدور للحالة غير الموثقة بنجاح ([SWS_Dcm_01486])، يظل هذا التعيين قائماً بشكل مؤقت:

• يتم تجاهل الدور المحدد بمجرد انتقال الاتصال إلى الحالة الموثقة (authenticated state) ([SWS_Dcm_01488]).
• تنتهي الصلاحية على أبعد تقدير عند إعادة ضبط وحدة التحكم الإلكترونية ([SWS_Dcm_91069]).

تستعلم الدالة المتزامنة ومتعددة الدخول (reentrant) Dcm_GetSecurityLevel عن مستوى الأمان النشط حاليًا لـ DCM وتوفره [SWS_Dcm_00338]. وتُعلن الدالة عبر الترويسة Dcm.h وتمرر قيمة الحالة المحددة عبر معلمة الإخراج SecLevel من النوع Dcm_SecLevelType* إلى جهة الاستدعاء. ووفقًا للمواصفة، يتم إرجاع E_OK دون استثناء كقيمة إرجاع [SWS_Dcm_00338].

يعتمد تحديد مستوى الأمان الداخلي على المعلمة SecurityAccessType المرسلة من قِبل جهاز الفحص ضمن إطار خدمة SecurityAccess وفقًا لصيغة التحويل الثابتة SecurityLevel = (SecurityAccessType + 1) / 2 [SWS_Dcm_00338].

في سياق التفاعل مع معالجة خدمات التشخيص ذات المستوى الأعلى، تعتمد الوحدة الفرعية DSP ضمن وحدات أخرى على هذه القيمة: إذا استلمت الوحدة طلبًا مُكوَّنًا بنوع الوظيفة الفرعية ”requestSeed“ (قيمة فردية) وكان مستوى الوصول المقترن نشطًا بالفعل وفقًا لـ Dcm_GetSecurityLevel، فإن الوحدة الفرعية DSP تضبط محتوى seed على 0x00 [SWS_Dcm_00323].

فيما يتعلق بالتزامن ومعالجة الأخطاء، تم تعريف الدالة على أنها متعددة الدخول (reentrant) [SWS_Dcm_00338]. وبما أنه لم يتم تحديد رموز أخطاء معينة أو فحوصات DET ويتم إرجاع E_OK دائمًا، يُرجح عدم إجراء أي فحص للمؤشر الفارغ (null pointer)؛ لذا يُرجح أنه يجب على جهات الاستدعاء دائمًا تمرير مؤشر صالح إلى مساحة ذاكرة لـ SecLevel. سؤال Q-5402d82ac0151b22 (مفتوح)

تتيح الدالة التزامنية Dcm_ResetToDefaultSession للتطبيق إعادة تعيين جلسة التشخيص النشطة إلى الجلسة الافتراضية (Default Session) [SWS_Dcm_00520]. ومن حالات الاستخدام النموذجية الإنهاء التلقائي لجلسة تشخيصية موسعة بمجرد تجاوز مركبة لحد سرعة محدد مسبقًا [SWS_Dcm_00520].

الاستخدام ومعالجة الأخطاء

• الواجهة والمعلمات: تتوفر الدالة عبر Dcm.h بمعرف الخدمة 0x2a، ولها التوقيع Std_ReturnType Dcm_ResetToDefaultSession (void) ولا تتطلب معلمات تمرير [SWS_Dcm_00520].
• قيمة الإرجاع والأخطاء: يتم إرجاع Std_ReturnType كنوع إرجاع، حيث يتم إرجاع القيمة E_OK دون استثناء [SWS_Dcm_00520]. لم يتم تحديد رموز أخطاء معينة، أو فحوصات وقت تشغيل DET، أو أحداث DEM في متطلبات هذا الاستدعاء.

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

يتم التنفيذ تزامنيًا ومُعلن عنه بأنه قابل لإعادة الدخول [SWS_Dcm_00520].

إلى جانب تغيير الجلسة الفعلي، تبدأ Dcm_ResetToDefaultSession إلزاميًا تغيير وضع لـ ModeDeclarationGroupPrototype DcmDiagnosticSessionControl [SWS_Dcm_01062]. وهنا تستدعي الدالة داخليًا SchM_Switch_<bsnp>_DcmDiagnosticSessionControl(RTE_MODE_DcmDiagnosticSessionControl_DCM_DEFAULT_SESSION) لإخطار بيئة النظام بالانتقال إلى الجلسة الافتراضية [SWS_Dcm_01062].

تُستخدم الدالة المتزامنة Dcm_TriggerOnEvent (معرف الخدمة 0x2D)، المتوفرة عبر الترويسة Dcm.h، لإطلاق حدث مرتبط بطلب ResponseOnEvent (ROE) [SWS_Dcm_00521].

الاستدعاء وطريقة العمل

يمرر المستدعي كمعامل وحيد RoeEventId (معامل إدخال من النوع uint8)، والذي يحدد الحدث المراد إطلاقه؛ ولا توجد معاملات إدخال أو إخراج أخرى [SWS_Dcm_00521]. بمجرد استدعاء الدالة، يتحقق DCM من حالة الحدث: إذا كان RoeEvent الممرر نشطًا، يُطلق DCM الحدث المقابل [SWS_Dcm_00920]. ينفذ DCM الخدمة المقترنة بالحدث، بشرط أن يكون الوضع المرتبط لـ RoeEventId مضبوطًا على 'ROE started' [SWS_Dcm_00521].

القيم المرجعة والتحقق من الصحة

يُرجع الاستدعاء بشكل متزامن حالة من النوع Std_ReturnType توفر معلومات حول صلاحية المعامل [SWS_Dcm_00521]:

• E_OK: القيمة الممررة لـ RoeEventId صالحة [SWS_Dcm_00521].
• E_NOT_OK: قيمة RoeEventId غير صالحة [SWS_Dcm_00521].

التزامن والخصائص

تم تحديد الواجهة على أنها قابلة لإعادة الدخول (reentrant) [SWS_Dcm_00521]. وبالتالي يمكن استدعاؤها بشكل تزامني للإبلاغ عن الأحداث بشكل متزامن إلى DCM [SWS_Dcm_00521].

يتم استدعاء الدالة المتزامنة والقابلة لإعادة الدخول Dcm_StartOfReception ([SWS_Dcm_00094]) بواسطة وحدة بروتوكول النقل في بداية استقبال N-SDU – سواء في الإطارات المفردة (Single Frame، SF) أو في الإطارات المقسمة (First Frame، FF). ويمكن استدعاؤها في سياق المقاطعة ([SWS_Dcm_00094]). يؤدي الاستدعاء من بين أمور أخرى إلى إيقاف مؤقت S3Server عند بدء الاستقبال ([SWS_Dcm_00141]).

عبر info يتم تمرير بيانات الحمولة والبيانات الوصفية؛ وفي الاتصالات العامة يتم عبرها من بين أمور أخرى تخزين SOURCE_ADDRESS_16 ([SWS_Dcm_00848]) بالإضافة إلى فحص TARGET_ADDRESS_16 ([SWS_Dcm_01347]). وإذا لم تكن هناك حمولة ولا بيانات وصفية، يتم تمرير NULL_PTR ([SWS_Dcm_00094]). وعبر bufferSizePtr تُرجع الدالة المخزن المؤقت المتاح لحساب حجم الكتلة Block Size (BS) ([SWS_Dcm_00094]). وفي حالة القبول الناجح تُرجع BUFREQ_OK، حيث يتم بعد ذلك نسخ البيانات اللاحقة عبر Dcm_CopyRxData ([SWS_Dcm_00443]).

تتم الإشارة إلى حالات الخطأ والرفض عبر قيمة الإرجاع:

• BUFREQ_E_OVFL: يتم إرجاعها إذا كان الطول المطلوب TpSduLength أكبر من المخزن المؤقت المتاح في DCM ([SWS_Dcm_00094]، [SWS_Dcm_00444]). ويبقى bufferSizePtr دون تغيير ([SWS_Dcm_00094]).
• BUFREQ_E_NOT_OK: يُرجع إذا كانت TpSduLength تساوي 0 ([SWS_Dcm_00642]) أو إذا كان هناك طلب قيد التنفيذ يحظر على نفس الاتصال ([SWS_Dcm_00557]). في حالة وجود اتصال آخر، تحدد المعلمة DcmDslDiagRespOnSecondDeclinedRequest ما إذا كان سيتم الرفض باستخدام BUFREQ_E_NOT_OK ([SWS_Dcm_00790]) أو القبول باستخدام BUFREQ_OK ([SWS_Dcm_00788]). كما يتم تأكيد طلبات TesterPresent المتزامنة باستخدام BUFREQ_OK ([SWS_Dcm_00557]).

الاستخدام

تُستدعى الدالة المتزامنة Dcm_CopyRxData لتمرير البيانات المستلمة لجزء I-PDU (أو N-PDU) إلى الطبقة العليا في DCM [SWS_Dcm_00556]. ويوفر كل استدعاء الجزء التالي من بيانات I-PDU [SWS_Dcm_00556]. ويتم عبر المعامل id تحديد I-PDU المستلمة [SWS_Dcm_00556]. يوفر المؤشر info عبر SduDataPtr ذاكرة التخزين المؤقت المصدرية وعبر SduLength عدد البايتات المراد نسخها [SWS_Dcm_00556]. بعد الانتهاء من عملية النسخ، يتم الإبلاغ عن حجم ذاكرة التخزين المؤقت الحرة المتبقية في DCM عبر bufferSizePtr [SWS_Dcm_00556]، [SWS_Dcm_00443].

إذا تم استدعاء Dcm_CopyRxData مع SduLength بقيمة 0، فإن هذا يخدم الاستعلام المجرد عن ذاكرة التخزين المؤقت [SWS_Dcm_00556]. وفي هذه الحالة يجوز أن يكون SduDataPtr هو NULL_PTR؛ وتُرجع الدالة BUFREQ_OK وتُدرج الحجم المتبقي لذاكرة التخزين المؤقت للاستقبال في bufferSizePtr [SWS_Dcm_00556]، [SWS_Dcm_00996].

تفاعل

قبل النسخ، يجب أن يكون Dcm_StartOfReception قد اكتمل بـ BUFREQ_OK؛ وتنسخ الاستدعاءات اللاحقة لـ Dcm_CopyRxData البيانات من ذاكرة التخزين المؤقت المقدمة إلى ذاكرة التخزين المؤقت لـ DCM وتحدث bufferSizePtr [SWS_Dcm_00443].

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

تُرجع الدالة الحالة كـ BufReq_ReturnType: يؤكد BUFREQ_OK النسخ الناجح أو الاستعلام عن ذاكرة التخزين المؤقت، بينما يشير BUFREQ_E_NOT_OK إلى أنه لم يتم نسخ أي بيانات بسبب خطأ [SWS_Dcm_00556]، [SWS_Dcm_00996].

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

تم تحديد Dcm_CopyRxData على أنها قابلة لإعادة الدخول ويجوز استدعاؤها في سياق المقاطعة [SWS_Dcm_00556]. وتتوفر الواجهة عبر Dcm.h [SWS_Dcm_00556].

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

يتم استدعاء الدالة المتزامنة Dcm_TpRxIndication بعد استقبال I-PDU عبر TP-API، عادةً بواسطة الوحدة PduR [SWS_Dcm_00093]، [SWS_Dcm_00112]. وتقوم بتمرير معرّف PDU (id) بالإضافة إلى نتيجة الاستقبال (result) ولا تُرجع أي قيمة إرجاع [SWS_Dcm_00093]. نظرًا لأن الدالة قابلة لإعادة الدخول ويجوز استدعاؤها في سياق المقاطعة (Interrupt)، يجب تصميم المتصلين وحالات الوحدة للتزامن المقابل [SWS_Dcm_00093].

السلوك في حالة الاستقبال الخاطئ

إذا تم استدعاء Dcm_TpRxIndication بقيمة نتيجة تختلف عن E_OK، فلا يجوز للوحدة Dcm تقييم المخزن المؤقت المخصص لـ I-PDU المشار إليها [SWS_Dcm_00344].

تفاعل الوحدات الفرعية

تقوم الوحدة الفرعية DSL بإعادة توجيه البيانات المستلمة إلى الوحدة الفرعية DSD فقط وحصريًا إذا تم الاستدعاء بقيمة المعلمة result = E_OK [SWS_Dcm_00111]. وتنطبق في هذا الصدد قواعد محددة على طلبات التشخيص:

• إذا كان الطلب المستلم بنجاح (Result = E_OK) هو الأمر TesterPresent مع ضبط suppressPosRspMsgIndicationBit (SID 0x3E، والوظيفة الفرعية 0x80)، فإن الوحدة الفرعية DSL تعيد ضبط مؤقت مهلة الجلسة S3Server [SWS_Dcm_00112].
• في هذه الحالة، لا تقوم الوحدة الفرعية DSL بإعادة توجيه الطلب إلى الوحدة الفرعية DSD لمزيد من التفسير [SWS_Dcm_00113].

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

تستدعي وحدات الطبقة السفلية (مثل بروتوكولات النقل) الدالة المتزامنة والقابلة لإعادة الدخول Dcm_CopyTxData لجلب بيانات جزء I-PDU (أو N-PDU) للإرسال [SWS_Dcm_00092]. وعبر المعامل info، يمرر المتصل ذاكرة التخزين المؤقت المستهدفة SduDataPtr والطول المطلوب بالبايت SduLength. ويمكن استخدام قيمة 0 لـ SduLength للإشارة إلى تغييرات الحالة عبر retry أو للاستعلام عن كمية البيانات المتاحة؛ ويجوز أن يكون SduDataPtr في هذه الحالة NULL_PTR [SWS_Dcm_00092]. وعبر availableDataPtr، يُبلغ DCM عن عدد البايتات المتبقية في ذاكرة التخزين المؤقت للإرسال، والتي يمكن أن تستخدمها وحدات TP لتحديد أحجام الأجزاء اللاحقة، ولا يجوز أن تتجاوز عدد البايتات التي لم تُرسل بعد [SWS_Dcm_00092]، [SWS_Dcm_00350].

إدارة ذاكرة التخزين المؤقت وتكرار الإرسال

عبر المعامل retry يتم التحكم في تأكيد استلام البيانات أو تكرارها [SWS_Dcm_00092]:

• إذا كان retry هو NULL_PTR، فيجوز إزالة البيانات من ذاكرة التخزين المؤقت مباشرة بعد عملية النسخ [SWS_Dcm_00092].
• عند TP_CONFPENDING، يجب أن تظل البيانات المنسوخة سابقًا في ذاكرة التخزين المؤقت لـ TP لمعالجة الأخطاء المحتملة [SWS_Dcm_00092].
• يؤكد TP_DATACONF جميع البيانات المنسوخة قبل هذا الاستدعاء للإفراج عنها [SWS_Dcm_00092].
• ينسخ TP_DATARETRY البيانات مجددًا بدءًا من الإزاحة TxTpDataCnt بالنسبة إلى الموضع الحالي [SWS_Dcm_00092].

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

إذا نُسخت البيانات بنجاح وبشكل كامل، تُرجع الدالة BUFREQ_OK [SWS_Dcm_00092]، [SWS_Dcm_00346]. وإذا لم تكن هناك بيانات إرسال كافية متاحة، فلن تُنفذ عملية نسخ ويتم إرجاع BUFREQ_E_BUSY؛ ويمكن للطبقة السفلية تكرار الاستدعاء لاحقًا [SWS_Dcm_00092]. وإذا فشل الطلب، تُرجع الدالة BUFREQ_E_NOT_OK [SWS_Dcm_00092]. وفي هذه الحالة، لا يكون طلب الإرسال من PduR_DcmTransmit() قد اكتمل بعد؛ وفقط استدعاء ختامي لـ Dcm_TpTxConfirmation ينهي العملية ويتيح عمليات إرسال جديدة [SWS_Dcm_00350].

التزامن

الدالة قابلة لإعادة الدخول ويجوز أيضًا استدعاؤها في سياق المقاطعة [SWS_Dcm_00092].

يتم استدعاء دالة رد النداء Dcm_TpTxConfirmation ([SWS_Dcm_00351]) تزامنيًا بواسطة طبقة النقل السفلية بعد إرسال I-PDU تشخيصية على الشبكة. يتم عبر المعلمة id تحديد I-PDU المعنية، بينما تبلغ result عن نجاح أو فشل عملية الإرسال ([SWS_Dcm_00351]). لا تحتوي الدالة على قيمة إرجاع، وهي قابلة لإعادة الدخول (reentrant) ويُسمح صراحةً بتنفيذها في سياق المقاطعة (interrupt context) ([SWS_Dcm_00351]).

عند استدعاء Dcm_TpTxConfirmation، تنفذ وحدة DCM عمليات تنظيف مركزية وانتقالات في الحالة:

• يتم إلغاء قفل مخزن الإرسال المؤقت المخصص ([SWS_Dcm_00352]).
• يتم إيقاف مراقبات الأخطاء الجارية مثل مهلات المخزن المؤقت للصفحات (Page-Buffer-Timeouts) ومهلات P2ServerMax وP2*ServerMax ([SWS_Dcm_00353]).
• يتم تحرير DcmPduId للاتصال، والتي كانت محظورة منذ الاستقبال (Dcm_TpRxIndication)، بحيث يمكن استقبال الطلبات اللاحقة ([SWS_Dcm_00241]).
• لا يتم إنهاء البروتوكول الحالي من خلال تأكيد استجابة DSL (لا يتم استدعاء xxx_StopProtocol) ([SWS_Dcm_00624]).

في حالة الخطأ (عندما تشير result إلى خطأ أو يتم تأكيد إلغاء بعد فشل Dcm_CopyTxData)، تتطلب [SWS_Dcm_00350] إلزاميًا هذا الاستدعاء الختامي لاختتام أمر الإرسال رسميًا وإتاحة عمليات إرسال جديدة عبر PduR_DcmTransmit(). في حالة التأكيد الخاطئ، لا يجوز للوحدة الفرعية DSD إعادة إرسال الاستجابة التشخيصية ([SWS_Dcm_00118]).

بالإضافة إلى ذلك، يمثل تأكيد استجابة (تختلف عن NRC 0x78) الاكتمال النظامي لطلب تشخيصي ([SWS_Dcm_01378]). بعد تأكيد استجابة إيجابية لـ EcuReset، تتجاهل DCM جميع الطلبات الأخرى أثناء معالجة إعادة الضبط ([SWS_Dcm_00834]).

الاستخدام

يتم استدعاء الواجهة المتزامنة Dcm_TxConfirmation (معرّف الخدمة 0x40، المعلنة في Dcm.h) وفقًا لـ [SWS_Dcm_01092] بواسطة وحدة واجهة الاتصال التابعة لتأكيد إرسال PDU أو للإبلاغ عن فشل النقل. لا تمتلك الدالة قيمة إرجاع وتُعالج معلمتي إدخال:

• TxPduId: معرّف (PduIdType) الـ PDU المرسلة.
• result: حالة النقل (Std_ReturnType). القيم الصالحة هي E_OK في حال النقل الناجح، وE_NOT_OK في حال فشل نقل الـ PDU.

معالجة الأخطاء والإبلاغ عن الحالة

يتم إرسال نتيجة النقل إلى DCM مباشرة عبر المعلمة result ([SWS_Dcm_01092]). ولم يتم تعريف رسائل خطأ محددة لـ DET أو DEM في مقتطف المواصفة المتاح لهذه الدالة.

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

فيما يتعلق بقابلية إعادة الدخول، فإن Dcm_TxConfirmation قابلة لإعادة الدخول للاستدعاءات ذات معرّفات PDU المختلفة، ولكنها غير قابلة لإعادة الدخول لنفس TxPduId ([SWS_Dcm_01092]). وتجدر الإشارة إلى أن الاستدعاء بواسطة الوحدة التابعة يمكن أن يتم في سياق المقاطعة ([SWS_Dcm_01092]).

تفاعل

في حالة النقل الدوري (PeriodicTransmission)، يتم استدعاء DCM وفقًا لـ [SWS_Dcm_01073] عبر Dcm_TxConfirmation لإبلاغه بنتيجة الإرسال المعنية.

تبلغ الدالة التزامنية وقابلة لإعادة الدخول Dcm_ComM_NoComModeEntered (معرف الخدمة 0x21) وحدة DCM بانتقال شبكة اتصال إلى الحالة COMM_NO_COMMUNICATION [SWS_Dcm_00356]. تتوفر الواجهة عبر ملف الترويسة Dcm_ComM.h، ولا تحتوي على قيمة إرجاع، وتحدد الشبكة المعنية عبر معلمة الإدخال NetworkId من النوع uint8 [SWS_Dcm_00356].

مع هذا الاستدعاء، تقوم DCM بإيقاف جميع الاتصالات على الشبكة المحددة، بحيث يتم تعطيل كل من استقبال وإرسال الرسائل بالكامل [SWS_Dcm_00148]. ويشمل ذلك إلزاميًا أنواع الإرسال التالية:

• منع عمليات إرسال ResponseOnEvent [SWS_Dcm_00149]،
• تعطيل عمليات الإرسال الدورية عبر ReadDataByPeriodicIdentifier (periodicId) [SWS_Dcm_00150] بالإضافة إلى
• إيقاف تشغيل عمليات الإرسال العادية [SWS_Dcm_00151].

ونتيجة لذلك، لا يجوز لوحدة DCM بعد تنفيذ Dcm_ComM_NoComModeEntered استدعاء دالة PduR المسماة PduR_DcmTransmit() لهذا السياق [SWS_Dcm_00152].

إذا تم استدعاء الدالة مع NetworkId لا تطابق أي قناة ComM مشار إليها في DCM عبر معلمة التكوين DcmDslProtocolComMChannelRef، فلا تنفذ وحدة DCM أي إجراء وتعود على الفور [SWS_Dcm_01324].

تُستخدم الدالة التزامنية وقابلة لإعادة الدخول Dcm_ComM_SilentComModeEntered ([SWS_Dcm_00358]) لإبلاغ وحدة DCM بانتقال شبكة اتصال إلى الحالة COMM_SILENT_COMMUNICATION. تمتلك الواجهة معرف الخدمة 0x22، ولا تُرجع أي قيمة، وتتوقع كمعلمة إدخال NetworkId معرف الشبكة المعنية ([SWS_Dcm_00358]). يتم توفيرها عبر ملف الترويسة Dcm_ComM.h ([SWS_Dcm_00358]).

بمجرد إجراء هذا الاستدعاء، يجب على DCM إيقاف جميع أنشطة الإرسال على قناة الشبكة المعنية بالكامل ([SWS_Dcm_00153]). ويتضمن ذلك تفصيليًا الإجراءات التالية:

• تعطيل جميع عمليات الإرسال العادية ([SWS_Dcm_00156])،
• منع عمليات إرسال Response-on-Event ([SWS_Dcm_00154]) بالإضافة إلى
• تعطيل عمليات الإرسال الدورية في إطار ReadDataByPeriodicIdentifier ([SWS_Dcm_00155]).

فيما يتعلق بمعالجة الأخطاء والشروط المحددة، فقد تقرر أنه يجب على DCM العودة دون أي إجراء آخر إذا كانت NetworkId الممررة تطابق قناة ComM غير مشار إليها في DCM عبر معلمة التكوين DcmDslProtocolComMChannelRef ([SWS_Dcm_01325]). لم يتم تحديد أخطاء تطوير محددة أو قيم إرجاع أخطاء لهذا الاستدعاء.

Interpretation: يُفترض أن يتم الاستدعاء عادةً بواسطة الوحدة ComM بمجرد إتمام الانتقال إلى وضع الاتصال الصامت. سؤال Q-fc9b6303ae0c0e41 (مفتوح)

تتوفر الدالة التزامنية وقابلة لإعادة الدخول Dcm_ComM_FullComModeEntered عبر ملف الترويسة Dcm_ComM.h وتبلغ وحدة DCM بانتقال شبكة اتصال إلى الحالة COMM_FULL_COMMUNICATION [SWS_Dcm_00360]. وتعمل المعلمة NetworkId كمعلمة إدخال تحدد الشبكة المتأثرة بتغيير الوضع [SWS_Dcm_00360].

من خلال الاستدعاء، يتم تنشيط جميع الاتصالات لهذه الشبكة، بحيث يتم تمكين كل من استقبال الرسائل وإرسالها [SWS_Dcm_00157]. ويشمل ذلك أنواع الإرسال التالية:

• عمليات الإرسال العادية [SWS_Dcm_00161]،
• عمليات إرسال Response-on-Event [SWS_Dcm_00159] بالإضافة إلى
• عمليات الإرسال الدورية بواسطة ReadDataByPeriodicIdentifier [SWS_Dcm_00160].

بمجرد استدعاء Dcm_ComM_FullComModeEntered، تعالج DCM الدوال الداخلية DslInternal_ResponseOnOneDataByPeriodicId() وDslInternal_ResponseOnOneEvent() دون قيود [SWS_Dcm_00162]. في التسلسل الزمني، يجب على DCM انتظار هذا الاستدعاء قبل بدء إرسال استجابة تشخيصية؛ ويجب ألا يتجاوز وقت الانتظار P2ServerMax بدءًا من وقت استلام الطلب [SWS_Dcm_01142].

في حالة الخطأ، إذا كانت NetworkId الممررة تتعلق بقناة ComM غير مهيأة في DCM (المعلمة DcmDslProtocolComMChannelRef)، تعود الدالة على الفور ودون أي إجراءات أخرى [SWS_Dcm_01326].

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

يستدعي Crypto Service Manager (CSM) دالة الاستدعاء الراجع المتزامنة والقابلة لإعادة الدخول Dcm_CsmAsyncJobFinished بمجرد اكتمال معالجة مهمة غير متزامنة [SWS_Dcm_91076]. وتستقبل كمعلمة إدخال عبر result من النوع Csm_ResultType نتيجة مهمة CSM المنتهية [SWS_Dcm_91076]. وكقيمة إرجاع، تُرجع الدالة دائمًا E_OK [SWS_Dcm_91076].

التكوين والشروط الحدية

يجب على مسؤولي التكامل تكوين اسم هذه الدالة في تكوين ECUC الخاص بـ CSM كاستدعاء راجع للمهام غير المتزامنة [SWS_Dcm_91076]. ويتوفر لـ DCM استدعاء راجع وحيد فقط من هذا النوع؛ ويتم تحديد المهمة المكتملة وفقًا للمواصفة من خلال تقييم معلمة المهمة [SWS_Dcm_91076]. ومع ذلك، نظرًا لأن توقيع دالة C لا يمرر سوى result، يُرجح أن تحدد DCM المهمة المرتبطة داخليًا عبر حالة المعاملة الخاصة بالمصادقة الجارية. سؤال Q-04ad1d5fb514f467 (مفتوح)

تتوفر الواجهة فقط إذا تم تعيين المعلمة DcmDspAuthenticationConnection في التكوين (لا تساوي null) [SWS_Dcm_91076]. لم تُحدَّد معالجات أخطاء معينة أو رسائل DET لهذا الاستدعاء، لأن قيمة الإرجاع هي دائمًا E_OK [SWS_Dcm_91076].

تستدعي الوحدة KeyM دالة الاستدعاء الراجع المتزامنة والقابلة لإعادة الدخول Dcm_KeyMAsyncCertificateVerifyFinished بعد اكتمال التحقق غير المتزامن من الشهادة [SWS_Dcm_91077]. وتُخطر DCM بالاكتمال وكذلك بنتيجة عملية الفحص وتُرجع كقيمة إرجاع دائمًا E_OK [SWS_Dcm_91077].

المعلمات وطريقة العمل

• CertID: معرّف الشهادة التي اكتمل التحقق منها. بناءً على هذا المعرّف، تحدد DCM أي مهمة فحص قد اكتملت [SWS_Dcm_91077].
• Result: قيمة الإرجاع وحالة مهمة التحقق غير المتزامنة من KeyM [SWS_Dcm_91077].

التكوين والشروط الحدية

يجب على مسؤولي التكامل تكوين اسم الدالة هذا في تكوين ECUC الخاص بـ KeyM كاستدعاء راجع للمهام غير المتزامنة [SWS_Dcm_91077]. ونظرًا لتوفر استدعاء راجع وحيد فقط لهذا الإشعار، تعتمد DCM على تحليل الشهادة المعنية عبر المعلمة CertID [SWS_Dcm_91077].

تتوفر الواجهة حصريًا إذا تم تكوين معلمة التكوين DcmDspAuthenticationConnection في المسار Dcm/DcmDsp/DcmDspAuthentication (!= null) [SWS_Dcm_91077]. لم تُحدَّد رموز خطأ خاصة أو رسائل DET لهذا الاستدعاء [SWS_Dcm_91077].

تُستخدم دالة الاستدعاء الخارجي Dcm_ReadMemory ([SWS_Dcm_00539])، المعلن عنها في Dcm_Externals.h، بواسطة DCM لقراءة بيانات ذاكرة الخادم استنادًا إلى عنوان البدء (MemoryAddress) وحجم البايت (MemorySize). وتلزم الدالة لخدمات UDS وهي ReadMemoryByAddress (0x23) ([SWS_Dcm_00495])، وReadDataByIdentifier (0x22) لمعرّفات DID الديناميكية في نطاق العناوين 0xF200 إلى 0xF3FF ([SWS_Dcm_00653])، وRequestUpload بالإضافة إلى TransferData ([SWS_Dcm_00539]). وإذا لم يُستخدم المعامل MemoryIdentifier، فيجب ضبطه على 0 ([SWS_Dcm_00539]).

الواجهة غير متزامنة وغير قابلة لإعادة الدخول ([SWS_Dcm_00539]). ويتم تمرير حالة الاستدعاء عبر OpStatus بالقيم DCM_INITIAL، أو DCM_PENDING، أو DCM_CANCEL، أو DCM_FORCE_RCRRP_OK. وطالما أن عملية القراءة مستمرة، تُرجع الدالة DCM_READ_PENDING ([SWS_Dcm_00985]). وإذا أرجع الاستدعاء DCM_READ_FORCE_RCRRP، يبدأ DCM على الفور إرسال رسالة RCR-RP (NRC 0x78) ويوقف الاستدعاءات الإضافية مؤقتًا حتى تأكيد الإرسال ([SWS_Dcm_00839]). وبعد تأكيد RCR-RP، يستدعي DCM الدالة من Dcm_MainFunction مجددًا باستخدام OpStatus = DCM_FORCE_RCRRP_OK ([SWS_Dcm_00840]).

في حالة النجاح، تُكتب البيانات المقروءة في المخزن المؤقت MemoryData ويتم إرجاع DCM_READ_OK ([SWS_Dcm_00539]، [SWS_Dcm_00985]). وإذا فشلت العملية، تُرجع الدالة DCM_READ_FAILED وتعيّن ErrorCode. عندئذٍ يرسل DCM استجابة سلبية بقيمة NRC المقابلة ([SWS_Dcm_00644]).

يستدعي DCM دالة الاستدعاء الخارجي Dcm_WriteMemory المعلن عنها في Dcm_Externals.h بشكل غير متزامن وغير قابل لإعادة الدخول لكتابة بيانات الذاكرة استنادًا إلى عنوان البدء وحجم البايت [SWS_Dcm_00540]. وتُستخدم لتنفيذ خدمات UDS التالية: WriteMemoryByAddress (0x3D)، وRequestDownload، وTransferData [SWS_Dcm_00540]. وعند استلام WriteMemoryByAddress، لا يستدعي DCM الاستدعاء الخارجي إلا بعد التحقق من صحة الطلب [SWS_Dcm_00491].

للتحكم في التسلسل، يتم تمرير OpStatus (القيم المحتملة: DCM_INITIAL، أو DCM_PENDING، أو DCM_CANCEL، أو DCM_FORCE_RCRRP_OK) [SWS_Dcm_00540]. ويحدد المعاملان MemoryAddress وMemorySize نطاق الذاكرة الهدف، بينما يشير MemoryData إلى المخزن المؤقت للتشخيص الخاص بـ DCM [SWS_Dcm_00540]. وإذا لم يتم استخدام MemoryIdentifier أو MemoryAddress (على سبيل المثال في حالة البيانات المضغوطة)، فيجب ضبطهما على 0 [SWS_Dcm_00540].

تحدد قيمة الإرجاع Dcm_ReturnWriteMemoryType [SWS_Dcm_00986] المعالجة الإضافية في DCM:

• DCM_WRITE_OK: تمت عملية الكتابة بنجاح [SWS_Dcm_00540]، [SWS_Dcm_00986].
• DCM_WRITE_PENDING: لم تكتمل العملية بعد وتتطلب استدعاءات متتابعة [SWS_Dcm_00540]، [SWS_Dcm_00986].
• DCM_WRITE_FORCE_RCRRP: يبدأ DCM على الفور إرسال استجابة معلقة Response Pending (NRC 0x78) ويعلّق الاستدعاءات الإضافية حتى تأكيد الإرسال [SWS_Dcm_00837]. وبعد ذلك يتم الاستدعاء من جديد من Dcm_MainFunction باستخدام DCM_FORCE_RCRRP_OK [SWS_Dcm_00838].
• DCM_WRITE_FAILED: في حالة حدوث خطأ، يرسل DCM استجابة سلبية بقيمة NRC الممررة عبر معامل الإخراج ErrorCode [SWS_Dcm_00540]، [SWS_Dcm_00643].

تتيح دالة الاستدعاء الخارجي Dcm_SetProgConditions لمكامل النظام الحفظ المستمر للمعلومات ذات الصلة قبل الانتقال إلى برنامج الإقلاع (Bootloader) أو إعادة التعيين نتيجة لطلب ECUReset [SWS_Dcm_00543]. وتُمرر بيانات السياق ذات الصلة عبر مؤشر إلى البنية Dcm_ProgConditionsType، والتي تجمع من بين أمور أخرى عناوين المصدر للاتصال وجهاز الاختبار، ومعرّفات الخدمة والوظيفة الفرعية، بالإضافة إلى أعلام التحكم مثل ReprogramingRequest وResponseRequired [SWS_Dcm_00988]. وعند استلام خدمة UDS 0x10 بوظيفة فرعية 0x02، يعيّن DCM هذه الأعلام ويستدعي الواجهة [SWS_Dcm_01182].

يتم الاستدعاء بشكل غير متزامن وغير قابل لإعادة الدخول (Non Reentrant) [SWS_Dcm_00543]. وعبر المعلمة OpStatus، يتم التحكم في الحالات DCM_INITIAL، أو DCM_PENDING، أو DCM_CANCEL، أو DCM_FORCE_RCRRP_OK [SWS_Dcm_00543]. وإذا استمر التنفيذ وأرجعت الدالة DCM_E_PENDING، فإن DCM يستدعي الواجهة مرة أخرى في دورة الدالة الرئيسية التالية لإتمام التعيين [SWS_Dcm_00543]، [SWS_Dcm_01184]. ويمكن عبر DCM_E_FORCE_RCRRP فرض إرسال استجابة معلقة (NRC 0x78) [SWS_Dcm_00543]. واعتمادًا على التكوين، لا يتم الاستدعاء بواسطة DCM إلا بعد نجاح نقل NRC 0x78 [SWS_Dcm_00535].

إذا عُيِّنت الشروط دون أخطاء وأرجعت دالة الاستدعاء الخارجي (Callout) E_OK، يُطلق DCM تغيير وضع ModeDeclarationGroupPrototype DcmEcuReset إلى EXECUTE [SWS_Dcm_00719]، [SWS_Dcm_01163]، [SWS_Dcm_01180]. أما إذا تعذر حفظ الحالة وأجابت الدالة بـ E_NOT_OK، فلن يُنفَّذ كل من إعادة التعيين والقفز إلى محمل الإقلاع (Bootloader)، ويُمنع تغيير الوضع، ويرسل DCM الاستجابة السلبية NRC 0x22 (Conditions not correct) [SWS_Dcm_00715]، [SWS_Dcm_01181].

تُستدعى دالة الاستدعاء الخارجي (Callout) Dcm_GetProgConditions برمز الخدمة 0x62 أثناء تهيئة DCM للتحقق مما إذا كان يلزم إرسال استجابة تشخيصية معلقة للخدمة $50 أو $51 [SWS_Dcm_00544]. ويتم توفير تصريح الواجهة عبر ملف الترويسة Dcm_Externals.h [SWS_Dcm_00544].

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

يتم تنفيذ الدالة بشكل متزامن، دون تمرير أي معلمات إدخال أو معلمات إدخال/إخراج نظامية [SWS_Dcm_00544]:

• معلمة الإخراج: عبر المؤشر ProgConditions من النوع Dcm_ProgConditionsType*، تُرجع دالة Callout الشروط التي طُلب القفز السابق بناءً عليها من محمل الإقلاع [SWS_Dcm_00544]. وتُخزَّن معلمات السياق ذات الصلة في نوع البيانات Dcm_ProgConditionsType [SWS_Dcm_00544].
• القيمة المرجعة: تُرجع الدالة قيمة حالة من النوع Dcm_EcuStartModeType إلى الجهة المستدعية [SWS_Dcm_00544].

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

صُنِّفت الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant)؛ لذا يُحظر تنفيذها بشكل متزامن [SWS_Dcm_00544]. ولا توجد رموز أخطاء محددة معرَّفة لدالة Callout هذه في مواصفة الواجهة لكل من DET أو DEM [SWS_Dcm_00544].

تستدعي DCM دالة الاستدعاء الخارجي (Callout-Funktion) Dcm_ProcessRequestAddFile لبدء الخدمة RequestFileTransfer بنمط التشغيل 0x01 (AddFile) ([SWS_Dcm_91078]). وهي متوفرة عبر Dcm_Externals.h، ولديها معرّف الخدمة 0x72 ومحددة بأنها غير قابلة لإعادة الدخول (Non Reentrant) وغير متزامنة ([SWS_Dcm_91078]).

يتم التحكم في تسلسل الاستدعاء غير المتزامن عبر المعلمة OpStatus:

• DCM_INITIAL: جميع معلمات الإدخال صالحة. يشمل ذلك مسار الملف واسمه (filePathAndName مع filePathAndNameLength)، والبايت dataFormatIdentifier (النيبل العلوي للضغط، والنيبل السفلي للتشفير) بالإضافة إلى حجم الملف غير المضغوط والمضغوط (fileSizeUncompressed، fileSizeCompressed) ([SWS_Dcm_91078]).
• DCM_PENDING وDCM_CANCEL وDCM_FORCE_RCRRP_OK: في هذه الاستدعاءات اللاحقة، يتم تعيين جميع معلمات الإدخال إلى 0x00 ([SWS_Dcm_91078]).

كقيم إرجاع، تُرجع الدالة E_OK عند التنفيذ الناجح، وDCM_E_PENDING عند استمرار المعالجة، أو DCM_E_FORCE_RCRRP إذا طلب التطبيق إرسال استجابة مؤقتة (NRC 0x78) ([SWS_Dcm_91078]، [SWS_Dcm_91086]). وفي حالة النجاح، تحدد maxNumberOfBlockLength الحد الأقصى المسموح به لطول كتلة رسائل TransferData المستقبلية بدون SID وعداد الكتل ([SWS_Dcm_91078]).

في حالة الخطأ، تُرجع الدالة E_NOT_OK. في هذه الحالة، يجب تمرير رمز استجابة سلبية (NRC) عبر المعلمة ErrorCode، والذي ترسله DCM في استجابة تشخيص سلبية إلى العميل ([SWS_Dcm_91078]). إذا تم تمكين التكوين DcmRequestFileTransferUsePort، تتوفر هذه الوظيفة بدلاً من ذلك كعملية منفذ ProcessRequestAddFile للواجهة RequestFileTransfer ([SWS_Dcm_91086]).

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

تستدعي DCM دالة الاستدعاء الخارجي Dcm_ProcessRequestDeleteFile لبدء حذف ملف (modeOfOperation = 0x02) على الخادم كجزء من خدمة التشخيص RequestFileTransfer [SWS_Dcm_91079]. الدالة معلنة في Dcm_Externals.h وتعمل بشكل غير متزامن وغير قابل لإعادة الدخول (Non Reentrant) [SWS_Dcm_91079].

يتم التمرير والتقييم استنادًا إلى المعلمة OpStatus:

• DCM_INITIAL: تشير إلى بدء العملية. وتكون جميع معلمات الإدخال هنا صالحة؛ وتمرر filePathAndName موقع واسم الملف المراد حذفه، والذي يُحدد طوله بالبايت عبر filePathAndNameLength [SWS_Dcm_91079].
• DCM_PENDING أو DCM_CANCEL أو DCM_FORCE_RCRRP_OK: أثناء المعالجة المستمرة أو الإلغاء، يتم تعيين جميع معلمات الإدخال إلى 0x00 [SWS_Dcm_91079].

كقيم إرجاع، تُرجع الدالة E_OK عند التنفيذ الناجح، وDCM_E_PENDING إذا كان التنفيذ لا يزال جاريًا ويتطلب استدعاءات إضافية، أو DCM_E_FORCE_RCRRP إذا طلب التطبيق إرسال رسالة وسيطة مع NRC 0x78 (Response Pending) [SWS_Dcm_91079]، بشكل مماثل للخدمة RequestFileTransfer [SWS_Dcm_91086].

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

إذا فشلت المعالجة، تُرجع الدالة E_NOT_OK. في هذه الحالة، يجب توفير رمز استجابة سلبية عبر معلمة الإخراج ErrorCode، والذي ترسله DCM كإفادة سلبية (NRC) إلى المفحوص [SWS_Dcm_91079].

تستدعي DCM دالة الاستدعاء الخارجي Dcm_ProcessRequestReplaceFile لبدء عملية تشخيص لـ RequestFileTransfer بنمط التشغيل 0x03 (ReplaceFile) [SWS_Dcm_91080]. تم تعريف الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant) وغير متزامنة وتُوفَّر عبر ملف الترويسة Dcm_Externals.h [SWS_Dcm_91080].

يتم التحكم في تسلسل المعالجة غير المتزامنة عبر المعلمة OpStatus:

• عند الاستدعاء الأولي مع DCM_INITIAL، تُمرر DCM جميع معلمات الإدخال بشكل صالح، بما في ذلك المسار واسم الملف (filePathAndName مع بيان الطول filePathAndNameLength)، ومعرّف الضغط والتشفير (dataFormatIdentifier) بالإضافة إلى حجم الملف غير المضغوط والمضغوط (fileSizeUncompressed، fileSizeCompressed) [SWS_Dcm_91080].
• في حالات الاستدعاءات اللاحقة أو الإلغاء (DCM_PENDING، DCM_CANCEL، DCM_FORCE_RCRRP_OK)، يتم ضبط جميع معاملات الدخل (In-Parameter) على 0x00 [SWS_Dcm_91080].
• في حال النجاح، تُرجع الدالة إلى DCM عبر معامل الخرج maxNumberOfBlockLength أقصى طول لبيانات الحمولة النافعة لطلبات TransferData اللاحقة (بدون SID وعداد تسلسل الكتل) [SWS_Dcm_91080].

كقيم إرجاع، تم تحديد E_OK عند التنفيذ الناجح، وDCM_E_PENDING عند استمرار المعالجة، وDCM_E_FORCE_RCRRP لطلب إشعار بتعليق الاستجابة (NRC 0x78) [SWS_Dcm_91080]، [SWS_Dcm_91086]. وإذا فشل التنفيذ، تُرجع الدالة E_NOT_OK وتُعيّن للمعامل ErrorCode كود الاستجابة التشخيصية السلبية (NRC) المقابل، والذي يُرسله DCM بدوره إلى جهاز الفحص (Tester) [SWS_Dcm_91080].

يستدعي DCM دالة الاستدعاء الخارجي (Callout) Dcm_ProcessRequestReadFile لبدء عملية نقل ملفات (الخدمة RequestFileTransfer) مع نمط التشغيل ReadFile (modeOfOperation 0x04) [SWS_Dcm_91081]. الدالة مصرّح عنها في ملف الرأس Dcm_Externals.h، وتعمل بشكل غير متزامن وليست قابلة لإعادة الدخول (Non Reentrant) [SWS_Dcm_91081].

يتم الاستدعاء عبر معامل الحالة OpStatus: عند الاستدعاء الأولي DCM_INITIAL تكون جميع معاملات الإدخال صالحة، بينما يتم ضبطها على 0x00 في الاستدعاءات اللاحقة باستخدام DCM_PENDING أو DCM_CANCEL أو DCM_FORCE_RCRRP_OK [SWS_Dcm_91081]. يتلقى التطبيق المسار واسم الملف عبر filePathAndName (الطول في filePathAndNameLength)، وصيغة الضغط والتشفير عبر dataFormatIdentifier، بالإضافة إلى أحجام الملف عبر fileSizeUncompressed وfileSizeCompressed [SWS_Dcm_91081]. كمعامل خرج، يجب على التطبيق تعيين maxNumberOfBlockLength بأقصى عدد بايتات لاستجابات TransferData اللاحقة (بدون SID وعداد تسلسل الكتل) [SWS_Dcm_91081].

كقيم إرجاع لـ Std_ReturnType، تم تعريف E_OK عند التنفيذ الناجح، أو DCM_E_PENDING عند استمرار المعالجة غير المتزامنة، أو DCM_E_FORCE_RCRRP لطلب استجابة «Response Pending» (NRC 0x78) [SWS_Dcm_91081]. وإذا فشلت العملية، فإنها تُرجع E_NOT_OK؛ وفي هذه الحالة، يُرسل DCM استجابة سلبية بقيمة NRC المحددة في معامل الخرج ErrorCode إلى جهاز الفحص [SWS_Dcm_91081]. يتوافق هذا التفاعل مع المعالجة العامة للخدمة RequestFileTransfer، تماماً كما يتم تكوينها بصورة مماثلة لعمليات الملفات الأخرى مثل ProcessRequestAddFile [SWS_Dcm_91086].

الاستخدام

يتم التصريح عن دالة الاستدعاء الخارجي Dcm_ProcessRequestReadDir عبر ملف الرأس Dcm_Externals.h ويستدعيها DCM لبدء الخدمة RequestFileTransfer بنمط التشغيل 0x05 (ReadDir) بشكل غير متزامن [SWS_Dcm_91082]. يتم التحكم في تقدم المعالجة عبر معامل التمرير OpStatus [SWS_Dcm_91082]. عند الاستدعاء الأول باستخدام DCM_INITIAL، يمرر DCM المسار أو الاسم عبر filePathAndName مع الطول بالبايت filePathAndNameLength [SWS_Dcm_91082]. وفي الاستدعاءات اللاحقة أو عند الإلغاء (DCM_PENDING، DCM_CANCEL، DCM_FORCE_RCRRP_OK)، يتم ضبط جميع معاملات الإدخال على 0x00 [SWS_Dcm_91082].

كقيم خرج، يجب على التطبيق تقديم حجم بيانات الدليل عبر dirInfoLength والحد الأقصى المسموح به لحجم الكتلة لعمليات النقل اللاحقة عبر maxNumberOfBlockLength [SWS_Dcm_91082]. وإلى جانب E_OK عند التنفيذ الناجح، يمكن للدالة إرجاع DCM_E_PENDING إذا كانت العملية لا تزال جارية، أو DCM_E_FORCE_RCRRP للتسبب في إرسال استجابة مؤقتة (NRC 0x78) [SWS_Dcm_91082].

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

في حال حدوث خطأ، يجب على الدالة إرجاع E_NOT_OK. وفي هذه الحالة، يقرأ DCM المعامل ErrorCode وينقل قيمته ككود استجابة سلبية (NRC) إلى جهاز الفحص [SWS_Dcm_91082]. لا تتوفر رسائل DET أو DEM محددة لهذه الواجهة؛ وبالتالي يُرجح أن تقع عمليات فحص الأخطاء للمسار الممرر بالكامل على عاتق التنفيذ الخاص بالتطبيق. سؤال Q-278dbc3db7b4363b (مفتوح)

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

تم تحديد الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant)، وبالتالي لا يجوز استدعاؤها بشكل متزامن لعدة طلبات تشخيصية [SWS_Dcm_91082]. وهي جزء من مجموعة واجهات الخدمة RequestFileTransfer، والتي يمكن التأثير على ربطها عبر معاملات التكوين [SWS_Dcm_91086].

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

يستدعي DCM دالة الاستدعاء الخارجي Dcm_WriteFile عند استلام بيانات عبر خدمة UDS المسماة TransferData (0x36) ووجود عملية تنزيل نشطة بدأت سابقاً بواسطة RequestFileTransfer بالأنماط 0x01 (AddFile) أو 0x03 (ReplaceFile) [SWS_Dcm_01444]. تتوفر الواجهة عبر Dcm_Externals.h [SWS_Dcm_91083].

يعتمد تعيين المعاملات على حالة التقدم OpStatus [SWS_Dcm_91083]:

• DCM_INITIAL: تكون جميع معاملات الإدخال صالحة. يشير المؤشر Data إلى بيانات الحمولة النافعة المراد كتابتها، ويحدد DataLength طولها بالبايت. لا تتجاوز قيمة DataLength الحد الأقصى لطول الكتلة الذي تم التفاوض عليه سابقاً عند Dcm_ProcessRequestFileTransfer (NumberOfBlockLength).
• DCM_PENDING وDCM_CANCEL وDCM_FORCE_RCRRP_OK: يتم ضبط جميع معاملات الإدخال على 0x00.

الدلالات غير المتزامنة وقيم الإرجاع

تعمل الدالة بشكل غير متزامن وغير قابل لإعادة الدخول (Non Reentrant) [SWS_Dcm_91083]. وتوفر قيم الحالة التالية:

• E_OK: اكتملت عملية الكتابة بنجاح.
• DCM_E_PENDING: لم تكتمل المعالجة بعد وتتطلب استدعاءات إضافية.
• DCM_E_FORCE_RCRRP: يطلب التطبيق إرسال استجابة انتظار (Response Pending، NRC 0x78).
• E_NOT_OK: فشلت العملية.

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

إذا أرجعت Dcm_WriteFile القيمة E_NOT_OK، ترسل وحدة DCM استجابة UDS سلبية يتطابق كود NRC الخاص بها مع القيمة المقدمة عبر معامل الخرج ErrorCode [SWS_Dcm_91083].

تستدعي وحدة DCM دالة الاستدعاء الخارجي Dcm_ReadFileOrDir عند استلام طلب متوافق مع الصيغة لخدمة UDS المسماة TransferData (0x36) ضمن عملية رفع جارية لملف أو دليل (بدأت سابقاً عبر خدمة UDS المسماة RequestFileTransfer بالنمط 0x04 لـ ReadFile أو 0x05 لـ ReadDir) [SWS_Dcm_01445]. تُستخدم الدالة لتوفير البيانات المراد إرسالها كاستجابة إلى العميل [SWS_Dcm_91085]. التصريح عن الواجهة متاح عبر ملف الرأس Dcm_Externals.h [SWS_Dcm_91085].

يتم التنفيذ بشكل غير متزامن ومحدد بأنه غير قابل لإعادة الدخول (Non Reentrant) [SWS_Dcm_91085]. يعتمد التفاعل وتعيين المعاملات على حالة التشغيل الممررة:

• حالة التشغيل (OpStatus): عند الاستدعاء الأولي بـ DCM_INITIAL، تكون جميع معاملات الإدخال صالحة. وفي استدعاءات المتابعة أو الإلغاء بـ DCM_PENDING أو DCM_CANCEL أو DCM_FORCE_RCRRP_OK، يتم ضبط جميع معاملات الإدخال على 0x00 [SWS_Dcm_91085].
• المخزن المؤقت وطول الكتلة: يمرر المعامل DataLength من جهة الدخل أقصى طول مسموح به للكتلة (بما يتوافق مع القيمة maxNumberOfBlockLength المبلغة للعميل)، ويُرجع من جهة الخرج الطول الفعلي بالبايت المتوفر في Data، والذي لا يجوز أن يتجاوز قيمة الدخل [SWS_Dcm_91085]. التفسير: على الرغم من أن Data مصرح عنه شكلياً في الواجهة كمعامل دخل، يُرجح أنه يُستخدم لتمرير بيانات الحمولة النافعة المراد قراءتها. سؤال Q-53de8a0bdbc4a2b4 (مفتوح)
• قيم الإرجاع: تُرجع العملية E_OK عند توفير البيانات بنجاح، أو DCM_E_PENDING عند عدم اكتمال المعالجة بعد، أو DCM_E_FORCE_RCRRP إذا أراد التطبيق فرض إرسال إشعار مؤقت (Response Pending، NRC 0x78) [SWS_Dcm_91085].

إذا فشلت المعالجة في التطبيق، يتم إرجاع E_NOT_OK. وفي حالة الخطأ هذه، ترسل وحدة DCM استجابة UDS سلبية (NRC) إلى العميل، ويتطابق كود الخطأ فيها مع القيمة المحددة في معامل الخرج ErrorCode [SWS_Dcm_91085].

تُستخدم الدالة Dcm_MainFunction لمعالجة المهام المركزية للحلقة الرئيسية لـ Diagnostic Communication Manager ([SWS_Dcm_00053]). وتمتلك التوقيع void Dcm_MainFunction(void) ولا تُرجع أي قيم. وبما أنها موفرة عبر ملف الترويسة SchM_Dcm.h، يُرجح أن استدعاءها يتم دوريًا في سياق مهمة مجدول للبرمجيات الأساسية. سؤال Q-e083a72aae447ab5 (مفتوح)

تتمثل إحدى المهام الأساسية في التحكم في الإجراءات غير المتزامنة ومواصلتها عبر الدورات:

• إذا أعادت عملية مع Dcm_OpStatusType القيمة المرجعة DCM_E_PENDING، فإن DCM يستدعي العملية مجددًا عند كل استدعاء لـ Dcm_MainFunction مع OpStatus = DCM_PENDING طالما استمرت هذه الحالة ([SWS_Dcm_00530]).
• إذا أعادت Dem_ClearDTC() الحالة DEM_PENDING، فسيتم استدعاء الدالة مجددًا في الدورة التالية لـ Dcm_MainFunction؛ ويرسل DCM عند الحاجة NRC 78 (ResponsePending) ([SWS_Dcm_00703]).
• يجب أن تتم استدعاءات Dem_SetDTCFilter() مع تعيين المعامل FilterForFault-DetectionCounter إلزاميًا في سياق Dcm_MainFunction ([SWS_Dcm_00519]).
• بعد تأكيد إرسال RCR-RP، يستدعي DCM العمليات مثل Dcm_WriteMemory أو Dcm_ReadMemory من Dcm_MainFunction مجددًا مع OpStatus = DCM_FORCE_RCRRP_OK ([SWS_Dcm_00529]، [SWS_Dcm_00838]، [SWS_Dcm_00840]).
• إذا تم الإبلاغ عن القيمة DCM_E_PENDING عند Xxx_GetSecurityAttemptCounter، فسيتم قطع الاستدعاء ومواصلته في الدورة التالية ([SWS_Dcm_01351])؛ وعند تجاوز المهلة الزمنية المهيأة، يُلغي DCM العملية المعلقة بـ OpStatus = DCM_CANCEL ([SWS_Dcm_01352]).

تُستخدم الدالة Xxx_GetSeed (المتوفرة عبر Dcm_Externals.h) لتوفير قيمة Seed بشكل غير متزامن بواسطة التطبيق لوحدة DCM [SWS_Dcm_01151]. ويتم استدعاؤها بمجرد استلام طلب UDS للخدمة SecurityAccess (0x27) بنوع الوظيفة الفرعية «requestSeed» وعدم تفعيل مستوى الأمان المطلوب بعد [SWS_Dcm_00862]، [SWS_Dcm_00324].

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

تم تعريف الواجهة على أنها غير قابلة لإعادة الدخول (Non Reentrant) وتعمل بشكل غير متزامن [SWS_Dcm_01151]:

• SecurityAccessDataRecord: مؤشر إلى بيانات إدخال إضافية لحساب Seed؛ ويبلغ الحد الأدنى للحجم بايتًا واحدًا وفقًا لـ DcmDspSecurityADRSize [SWS_Dcm_01151].
• OpStatus: يحدد الحالة الحالية للعملية غير المتزامنة [SWS_Dcm_01151].
• Seed: مؤشر إخراج يوفر التطبيق من خلاله قيمة Seed المحسوبة [SWS_Dcm_01151].
• ErrorCode: معلمة إخراج لإرجاع رمز خطأ سلبي (NRC) [SWS_Dcm_01151].

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

• E_OK: تم تحديد قيمة Seed وتوفيرها بنجاح [SWS_Dcm_01151].
• DCM_E_PENDING: لم يكتمل الحساب بعد؛ ويلزم إجراء حسابات أو استدعاءات لاحقة لإتمامه [SWS_Dcm_01151].
• E_NOT_OK: فشل الطلب. في هذه الحالة، ترسل وحدة DCM استجابة UDS سلبية تتضمن قيمة NRC الممررة في المعلمة ErrorCode [SWS_Dcm_01151]، [SWS_Dcm_00659].

إرشادات التكامل

اعتمادًا على تكوين DcmDspSecurityUsePort، يتم الربط كدالة C عند USE_ASYNCH_FNC (يُشار إليها عبر DcmDspSecurityGetSeedFnc) [SWS_Dcm_00862] أو كعملية Rte عند USE_ASYNCH_CLIENT_SERVER [SWS_Dcm_00324]. وإذا لم تكن هناك حاجة لتمرير بيانات وصول إضافية، يُستخدم توقيع الدالة البديل دون المعلمة SecurityAccessDataRecord [SWS_Dcm_91003].

تعمل الدالة Xxx_GetSeed كواجهة غير تزامنية من الوحدة DCM إلى التطبيق لتوفير قيمة بذرة (seed) عند وجود طلب من النوع «requestSeed» في إطار خدمة UDS المسماة SecurityAccess (0x27) [SWS_Dcm_91003]، [SWS_Dcm_00862]. يتم الاستدعاء بواسطة الوحدة الفرعية DCM-DSP ما لم تكن درجة الأمان نشطة بعد وإذا كان التكوين ينص على USE_ASYNCH_CLIENT_SERVER أو USE_ASYNCH_FNC [SWS_Dcm_00324]، [SWS_Dcm_00862].

تم تنفيذ الواجهة لتكون غير تزامنية وغير قابلة لإعادة الدخول (Non Reentrant) [SWS_Dcm_91003]. يتم التحكم في تقدم المعالجة عبر معلمة الإدخال OpStatus (النوع Dcm_OpStatusType) [SWS_Dcm_91003]. تم تعريف قيم الإرجاع لتكون E_OK عند التوفير الناجح، وE_NOT_OK في حالة الخطأ، بالإضافة إلى DCM_E_PENDING إذا كان توليد البذرة لا يزال مستمرًا وكانت هناك حاجة لاستدعاءات أخرى [SWS_Dcm_91003]. يتم تمرير القيمة المولدة عبر المؤشر Seed (مخزن مؤقت للدخل/الخرج أو الخرج) [SWS_Dcm_91003].

إذا فشلت العملية وأرجعت Xxx_GetSeed القيمة E_NOT_OK، فيجب على وحدة DCM إرسال استجابة سلبية (NRC) برمز الخطأ الذي تم تعيينه عبر معلمة الإخراج ErrorCode (Dcm_NegativeResponseCodeType) [SWS_Dcm_91003]، [SWS_Dcm_00659]. تم الإعلان عن الخدمة عبر ملف الترويسة Dcm_Externals.h [SWS_Dcm_91003].

يتم استدعاء الدالة Xxx_CompareKey من قِبل Diagnostic Communication Manager ([SWS_Dcm_91004]) بشكل غير تزامني وغير قابل لإعادة الدخول، لمطابقة مفتاح تم استقباله في إطار خدمة UDS المسمّاة SecurityAccess (0x27، الوظيفة الفرعية sendKey) مع المنطق الداخلي للتطبيق ([SWS_Dcm_00863]). وتُستخدم عندما لا تكون حالة الوصول نشطة بعد، ويكون طلب القيمة الأولية (Seed) ناجحًا، وتكون معلمة التهيئة DcmDspSecurityUsePort مضبوطة على USE_ASYNCH_CLIENT_SERVER ([SWS_Dcm_00324])، أو عندما تكون واجهة الدالة مهيأة عبر USE_ASYNCH_FNC/DcmDspSecurityCompareKeyFnc وفقًا لـ [SWS_Dcm_00863]. وتم التصريح عن الواجهة في Dcm_Externals.h ([SWS_Dcm_91004]).

يتضمن التمرير مؤشر المفتاح المراد فحصه Key، وحالة العملية الحالية OpStatus (من النوع Dcm_OpStatusType)، بالإضافة إلى المؤشر ErrorCode لرمز الاستجابة السلبية الواجب إصداره في حالة الخطأ ([SWS_Dcm_91004]). وقد حُددت قيم الإرجاع التالية:

• E_OK: نجاح فحص المفتاح ([SWS_Dcm_91004]).
• DCM_E_PENDING: لم يكتمل الفحص بعد؛ ويلزم إجراء استدعاءات إضافية بواسطة وحدة DCM لإنهائه ([SWS_Dcm_91004]).
• E_NOT_OK: المعالجة غير ناجحة. ويرسل DCM بعد ذلك استجابة UDS سلبية باستخدام رمز NRC المضبوط في ErrorCode، دون تغيير مستوى الأمان الداخلي أو زيادة عداد المحاولات الفاشلة (AttemptCounter) ([SWS_Dcm_01150]).
• DCM_E_COMPARE_KEY_FAILED: المفتاح غير متطابق ([SWS_Dcm_91004]).

إذا فشلت مطابقة المفتاح (DCM_E_COMPARE_KEY_FAILED)، تتم زيادة AttemptCounter في حال تهيئة DcmDspSecurityNumAttDelay ([SWS_Dcm_01397]). وإذا كان العداد أقل من القيمة الحدية، يرسل DCM الرمز NRC 0x35 (InvalidKey) ([SWS_Dcm_00660]). وإذا وصل عدد المحاولات الفاشلة إلى الحد المهيأ DcmDspSecurityNumAttDelay أو تجاوزه، يبدأ DCM الـ SecurityDelayTimer بالمدة الزمنية DcmDspSecurityDelayTime ويرسل الرمز NRC 0x36 (exceededNumberOfAttempts) ([SWS_Dcm_01349]). وفي كلتا الحالتين، يظل مستوى الأمان دون تغيير.

تقرأ الدالة غير المتزامنة وغير القابلة لإعادة الدخول [SWS_Dcm_01152] عند تهيئة DCM عداد المحاولات الفاشلة الحالي لمستوى أمان مهيأ من التطبيق. ويتم الاستدعاء لكل إدخال في DcmDspSecurityRow تم ضبط معلمة التكوين DcmDspSecurityAttemptCounterEnabled فيه على TRUE [SWS_Dcm_01154].

تتم إدارة التحكم في التدفق عبر المعلمة OpStatus بالقيم DCM_INITIAL أو DCM_PENDING أو DCM_CANCEL [SWS_Dcm_01152]. إذا أرجعت الدالة DCM_E_PENDING، يقطع DCM سلسلة الاستدعاء ويستأنفها في الدورة اللاحقة من Dcm_MainFunction() [SWS_Dcm_01351]. وإذا تم تجاوز مراقبة الوقت DcmDspSecurityMaxAttemptCounterReadoutTime المهيأة بعد الدورة الأولى، يُلغي DCM العملية التي لا تزال معلقة باستخدام DCM_CANCEL [SWS_Dcm_01352].

في حالة النجاح، تُرجع الواجهة E_OK وتمرر قيمة العداد عبر معلمة الإخراج AttemptCounter [SWS_Dcm_01152]. وإذا أرجع الاستدعاء E_NOT_OK، يضبط DCM العداد تلقائيًا على القيمة DcmDspSecurityNumAttDelay المهيأة لمستوى الأمان هذا [SWS_Dcm_01156].

طالما لم يتم تحديد جميع قيم العدادات نهائيًا أو إلغاؤها، يرفض DCM أي طلب لـ SecurityAccess (0x27) لطلب Seed باستخدام رمز الاستجابة السلبي conditionsNotCorrect (0x22) [SWS_Dcm_01354]. وبعد اكتمال سلسلة الاستعلام، يفحص DCM قيم العدادات: إذا وصل عداد واحد على الأقل إلى القيمة العتبية DcmDspSecurityNumAttDelay أو تجاوزها، يبدأ DCM تشغيل SecurityDelayTimer بالقيمة الأعلى من بين DcmDspSecurityDelayTimeOnBoot وDcmDspSecurityDelayTime [SWS_Dcm_01355].

تُستخدم الدالة Xxx_SetSecurityAttemptCounter لضبط عداد المحاولات لمستوى أمان محدد في التطبيق ([SWS_Dcm_01153]). ويتم توفيرها عبر ملف الترويسة Dcm_Externals.h.

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

يتم التنفيذ بشكل غير متزامن ومحدد على أنه غير قابل لإعادة الدخول (Non Reentrant) ([SWS_Dcm_01153]). ويتحكم الاستدعاء في التدفق عبر المعلمة OpStatus بالقيم DCM_INITIAL أو DCM_PENDING أو DCM_CANCEL. ويتم تمرير قيمة العداد الجديدة عبر معلمة الإدخال AttemptCounter (uint8).

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

يُستخدم Std_ReturnType كنوع إرجاع ([SWS_Dcm_01153]):

• E_OK: اكتمل الطلب بنجاح.
• E_NOT_OK: لم يكن التنفيذ ناجحاً.
• DCM_E_PENDING: لم تنتهِ المعالجة بعد؛ ويلزم إجراء استدعاءات إضافية للإتمام.

إذا تم إلغاء عملية غير متزامنة قيد التشغيل، يمرر DCM الحالة DCM_CANCEL ([SWS_Dcm_01153]).

التفاعل والشروط الحدية

تستدعي وحدة DCM الدالة Xxx_SetSecurityAttemptCounter بمجرد تغييرها لعداد المحاولات لإخطار التطبيق بالتحديث ([SWS_Dcm_01155]). ويتطلب ذلك تكوين معلمة التكوين DcmDspSecurityAttemptCounterEnabled لـ DcmDspSecurityRow المرتبطة بها على TRUE ([SWS_Dcm_01155]). ونظرًا لأن الواجهة غير قابلة لإعادة الدخول، يجب على التطبيق استبعاد التنفيذ المتزامن لنفس المثيل ([SWS_Dcm_01153]).

تطلب الدالة المتزامنة Xxx_ReadData من التطبيق قيمة البيانات الحالية لـ DID أو PID عندما تكون معلمة التكوين DcmDspDataUsePort مضبوطة على USE_DATA_SYNCH_CLIENT_SERVER [SWS_Dcm_00793]. وتتوفر الواجهة عبر الترويسة Dcm_Externals.h وتمتلك معرّف الخدمة 0x34 [SWS_Dcm_00793]. وينسخ التطبيق المستدعى البيانات المفيدة المطلوبة مباشرة إلى المخزن المؤقت الممرر Data [SWS_Dcm_00793].

فيما يتعلق بقيمة الإرجاع، تم تحديد أن الاستدعاء يرجع E_OK دون استثناء [SWS_Dcm_00793]. ولم يتم تحديد رموز أخطاء معينة أو ردود سلبية أو رسائل DET/DEM لهذا التوقيع. تفسير: يُرجح أن فشل توفير البيانات غير متوقع على مستوى هذه الواجهة، نظرًا لأنه، على عكس المتغير غير المتزامن [SWS_Dcm_91005]، لا توجد معلمة ErrorCode لرموز الاستجابة السلبية (NRC) ولا قيم إرجاع مثل E_NOT_OK أو DCM_E_PENDING. سؤال Q-adcf0171ecfd37c4 (مفتوح)

فيما يتعلق بالتزامن والشروط الحدية، تم تحديد الدالة على أنها غير متعددة الدخول (Non Reentrant) وتعمل بشكل متزامن تمامًا [SWS_Dcm_00793]. ويتم التفاعل مع طلبات التشخيص في عدة سيناريوهات:

• عند استقبال طلب خدمة OBD برمز $01 يتضمن PIDs غير متوفرة، يستدعي DCM دوال Xxx_ReadData المكونة لكل منها لكافة بيانات PID بهدف تسجيل قيم الاستجابة [SWS_Dcm_00408].
• عند وجود طلب UDS للخدمة 0x22 (ReadDataByIdentifier) يتضمن معرّفات غير متوفرة، يستدعي DCM الدوال لكافة بيانات OBDDataIdentifier [SWS_Dcm_01380] وكذلك OBDInfoTypeDataIdentifier [SWS_Dcm_01389].
• أما إذا كان السلوك غير المتزامن مطلوبًا، فتُستخدم التواقيع المنفصلة مع OpStatus وفقًا لـ [SWS_Dcm_91006] أو [SWS_Dcm_91005].

تُستخدم الدالة Xxx_ReadData للاستعلام عن قيم بيانات DID أو PID بشكل غير متزامن من التطبيق، بشرط تهيئة المعلمة DcmDspDataUsePort على USE_DATA_ASYNCH_CLIENT_SERVER ([SWS_Dcm_91006]). ويتم التصريح عنها عبر ملف الرأس Dcm_Externals.h ([SWS_Dcm_91006]).

عند الاستدعاء، تتحكم المعلمة OpStatus (من النوع Dcm_OpStatusType) في تقدم العملية الجارية، بينما يتم عبر المؤشر Data (من النوع uint8*) تمرير مخزن الإخراج المؤقت الذي يجب نسخ البيانات المطلوبة إليه ([SWS_Dcm_91006]). وتُحدد قيم الإرجاع بـ E_OK عند الاكتمال بنجاح، وDCM_E_PENDING إذا كانت المعالجة لا تزال مستمرة وتتطلب استدعاءات إضافية لإتمامها ([SWS_Dcm_91006]).

تدمج وحدة DCM هذه الدالة في تسلسلات التشخيص التالية:

• عند استلام OBD Service $01، تقرأ DCM قيم PID الحالية (باستثناء PIDs الخاصة بقابلية الإتاحة) عبر دوال Xxx_ReadData المهيأة ([SWS_Dcm_00408]).
• في حالة UDS Service 0x22 (ReadDataByIdentifier)، تستدعي DCM الدالة لكل من OBDDataIdentifier ([SWS_Dcm_01380]) وOBDInfoTypeDataIdentifier ([SWS_Dcm_01389]).

فيما يتعلق بالتنفيذ، تم تحديد الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant) ([SWS_Dcm_91006]). وبخلاف الواجهة المتزامنة ([SWS_Dcm_00793]) أو المتغير غير المتزامن المزود بمعلمة ErrorCode إضافية ([SWS_Dcm_91005])، لا ينص هذا الشكل من الدالة على إرجاع مباشر لرمز استجابة سلبية.

تطلب الدالة Xxx_ReadData من التطبيق بشكل غير تزامني قيمة بيانات DID أو PID، بشرط ضبط معلمة التكوين DcmDspDataUsePort على USE_DATA_ASYNCH_CLIENT_SERVER [SWS_Dcm_91005]. يتم توفير إعلان الدالة عبر ملف الواجهة Dcm_Externals.h [SWS_Dcm_91005].

تمتلك الواجهة خصائص الاستدعاء والتشغيل التالية:

• الدلالة والمعلمات: تتحكم معلمة الإدخال OpStatus في تقدم العملية الجارية [SWS_Dcm_91005]. عند الاكتمال بنجاح، يتم نسخ بيانات الحمولة المطلوبة إلى المخزن المؤقت للإخراج Data وإرجاع E_OK [SWS_Dcm_91005]. إذا كان التطبيق بحاجة إلى مزيد من وقت المعالجة، فإنه يشير إلى DCM_E_PENDING، وعندها تكون الاستدعاءات اللاحقة مطلوبة [SWS_Dcm_91005].
• معالجة الأخطاء: إذا فشلت العملية وأرجعت E_NOT_OK، تقيّم وحدة DCM معلمة الإخراج ErrorCode وترسل استجابة تشخيصية سلبية برمز NRC هذا [SWS_Dcm_91005].
• التزامن: تم تعريف الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_Dcm_91005]. Interpretation: يُفترض أن تتم الاستدعاءات المتكررة في حالة المعالجة المعلقة بالتتابع ضمن دورة المعالجة الرئيسية لـ DCM. سؤال Q-541226d5f242f7c2 (مفتوح)
• التفاعل: تستدعي وحدة DCM الدالة عند طلبات OBD Service $01 لمعرفات PID غير المتاحة [SWS_Dcm_00408] وكذلك عند UDS Service ReadDataByIdentifier (0x22) لـ OBDDataIdentifier [SWS_Dcm_01380] وOBDInfoTypeDataIdentifier [SWS_Dcm_01389]. بالمقارنة مع المتغير التزامني [SWS_Dcm_00793] أو الواجهات غير التزامنية بدون معلمة NRC [SWS_Dcm_91006]، يتيح هذا التوقيع إرسال خطأ سلبي محدد.

الاستخدام

تُستدعى الدالة Xxx_WriteData بواسطة Diagnostic Communication Manager (DCM) لمطالبة التطبيق بكتابة قيمة بيانات DID (معرّف البيانات) ([SWS_Dcm_00794]). ويتم توفير التصريح عبر ملف الترويسة Dcm_Externals.h. ويتم الاستدعاء بشكل متزامن تحت معرّف الخدمة 0x51 ([SWS_Dcm_00794]).

المعلمات والقيم المرجعة:

• Data (دخل): مؤشر إلى المخزن المؤقت المحتوي على حمولة البيانات المراد كتابتها ([SWS_Dcm_00794]).
• ErrorCode (خرج): مؤشر إلى المتغير الذي سيُدرج فيه رمز الاستجابة السلبية للتشخيص (NRC) في حال الفشل ([SWS_Dcm_00794]).
• القيمة المرجعة (Std_ReturnType): تُشير E_OK إلى نجاح الكتابة، بينما تُشير E_NOT_OK إلى فشل العملية ([SWS_Dcm_00794]).

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

إذا أرجعت الدالة E_NOT_OK، يقرأ مكوِّن DCM المعلمة ErrorCode ويرسل استجابة تشخيصية سلبية باستخدام رمز NRC هذا ([SWS_Dcm_00794]).

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

حُدِّدت الدالة في المواصفة على أنها غير قابلة لإعادة الدخول (Non Reentrant) ([SWS_Dcm_00794]) ويُحظر تنفيذها بشكل متزامن.

تفاعل

نظرًا لعدم وجود معلمة للطول، يُرجَّح أن هذا الخيار مخصص لمعرّفات DIDs ذات طول البيانات الثابت. سؤال Q-ebc074ac1cb66aaa (مفتوح) أما لمعرّفات DIDs ذات الطول المتغير، فيوفر AUTOSAR التوقيع المتزامن مع المعلمة DataLength ([SWS_Dcm_91007]). بالإضافة إلى ذلك، تتوفر للعمليات الطويلة بدائل غير متزامنة مع OpStatus وإمكانية إرجاع DCM_E_PENDING، سواء بأطوال بيانات ثابتة ([SWS_Dcm_91008]) أو مع معلمة طول متغير ([SWS_Dcm_91009]).

تُستخدم دالة رد النداء Xxx_WriteData لمطالبة التطبيق بكتابة قيمة بيانات Data Identifier (DID) [SWS_Dcm_91007]. تم التصريح عن الواجهة عبر الرأس Dcm_Externals.h وتمتلك معرف الخدمة 0x52 [SWS_Dcm_91007]. يتم الاستدعاء بشكل متزامن ومحدد بأنه غير قابل لإعادة الدخول (Non Reentrant)، ولهذا السبب لا يُسمح بأي استدعاءات متزامنة لنفس الدالة [SWS_Dcm_91007].

تستقبل الدالة كمعلمات كلاً من المخزن المؤقت Data الذي يحتوي على البيانات المفيدة المراد كتابتها، بالإضافة إلى DataLength الذي يحدد الطول بالبايت [SWS_Dcm_91007]. وكقيمة إرجاع، تقدم النوع Std_ReturnType مع E_OK عند التنفيذ الناجح، أو E_NOT_OK في حالة الخطأ [SWS_Dcm_91007]. وإذا فشلت العملية وأرجعت E_NOT_OK، فيجب على وحدة DCM إرسال استجابة سلبية إلى فاحص التشخيص؛ حيث يتوافق Negative Response Code (NRC) مع القيمة المنقولة عبر معامل المؤشر ErrorCode [SWS_Dcm_91007].

في النظام ككل، تمثل [SWS_Dcm_91007] المتغير المتزامن لـ DIDs مع تحديد صريح للطول. وبالإضافة إلى ذلك، يتوفر مع [SWS_Dcm_00794] (معرف الخدمة 0x51) متغير متزامن بدون المعلمة DataLength. بالنسبة لعمليات الكتابة الأطول، ينص المعيار على واجهات غير متزامنة: [SWS_Dcm_91008] (معرف الخدمة 0x35) بدون تحديد الطول، بالإضافة إلى [SWS_Dcm_91009] (معرف الخدمة 0x3e) مع DataLength. ويتم التحكم في كلتا الدالتين غير المتزامنتين عبر OpStatus، ويمكنهما، بالإضافة إلى E_OK وE_NOT_OK، إرجاع DCM_E_PENDING أيضًا [SWS_Dcm_91008] [SWS_Dcm_91009].

الاستخدام

تطلب الدالة Xxx_WriteData من التطبيق كتابة قيمة بيانات Data Identifier (DID) [SWS_Dcm_91008]. تم التصريح عنها في ملف الرأس Dcm_Externals.h ولديها دلالات تنفيذ غير متزامنة مع معرف الخدمة 0x35 [SWS_Dcm_91008].

تنقسم المعلمات وقيم الإرجاع على النحو التالي [SWS_Dcm_91008]:

• Data (IN): مؤشر إلى المخزن المؤقت الذي يحتوي على البيانات المراد كتابتها.
• OpStatus (IN): حالة العملية الحالية للتحكم في تسلسل الاستدعاء غير المتزامن.
• ErrorCode (OUT): مؤشر إلى رمز الخطأ (NRC)، الذي يتم تعيينه في حالة الخطأ.
• قيمة الإرجاع (Std_ReturnType): تؤكد E_OK نجاح عملية الكتابة، بينما تبلغ E_NOT_OK عن فشل، وتشير DCM_E_PENDING إلى أن العملية لا تزال جارية وتتطلب مزيدًا من الاستدعاءات لإتمامها.

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

إذا أرجع الاستدعاء القيمة E_NOT_OK، فيجب على وحدة DCM إرسال استجابة سلبية بقيمة NRC الممررة في معلمة الإخراج ErrorCode [SWS_Dcm_91008]. تم تحديد الدالة على أنها غير قابلة لإعادة الدخول [SWS_Dcm_91008]، بحيث لا يُسمح بالاستدعاءات المتزامنة أو المتداخلة لنفس النسخة.

التفاعل والمتغيرات

تغطي هذه الواجهة وفقًا لـ [SWS_Dcm_91008] الوصول للكتابة غير المتزامنة بدون معلمة طول منفصلة. يحدد AUTOSAR متغيرات ذات صلة في DCM لهذا الغرض: توقيع متزامن بدون تحديد الطول [SWS_Dcm_00794] بالإضافة إلى تواقيع بمعلمة إضافية DataLength للتسلسلات المتزامنة [SWS_Dcm_91007] وغير المتزامنة [SWS_Dcm_91009].

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

تطلب الدالة Xxx_WriteData من التطبيق كتابة قيمة بيانات Data Identifier (DID) [SWS_Dcm_91009]. يتم التصريح عنها عبر ملف الرأس Dcm_Externals.h ولديها معرف الخدمة 0x3e [SWS_Dcm_91009]. ويتم التنفيذ بشكل غير متزامن (Asynchronous)، حيث يتم تمرير المعلمات التالية:

• Data (in): مؤشر إلى المخزن المؤقت الذي يحتوي على البيانات المفيدة المراد كتابتها [SWS_Dcm_91009].
• DataLength (in): طول البيانات المراد كتابتها بالبايت [SWS_Dcm_91009].
• OpStatus (in): حالة العملية (Dcm_OpStatusType) للتحكم في تقدم المعالجة غير المتزامنة [SWS_Dcm_91009].
• ErrorCode (out): مؤشر لاستقبال رمز استجابة سلبية (NRC) في حالة الخطأ [SWS_Dcm_91009].

كقيم إرجاع من النوع Std_ReturnType، تم تحديد E_OK (اكتمل طلب الكتابة بنجاح)، وE_NOT_OK (فشل الطلب)، بالإضافة إلى DCM_E_PENDING [SWS_Dcm_91009]. وتشير الحالة DCM_E_PENDING إلى أن العملية لم تنتهِ بعد وأن استدعاءات متتابعة إضافية مطلوبة لإتمامها [SWS_Dcm_91009]. التفسير: يُرجح أن تقوم DCM بإعادة استدعاء الدالة دوريًا عند إرجاع DCM_E_PENDING مع استمرار OpStatus حتى تتوفر نتيجة نهائية. سؤال Q-fdbd734dab052f5c (مفتوح)

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

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

التفاعل ومتغيرات الواجهة

يغطي التوقيع [SWS_Dcm_91009] عمليات الوصول للكتابة غير المتزامنة مع تحديد صريح للطول. وتوجد متغيرات أخرى لـ Xxx_WriteData في DCM:

• تنفيذ متزامن بدون تحديد الطول: [SWS_Dcm_00794] (معرف الخدمة 0x51).
• تنفيذ متزامن مع تحديد الطول: [SWS_Dcm_91007] (معرف الخدمة 0x52).
• تنفيذ غير متزامن بدون تحديد الطول: [SWS_Dcm_91008] (معرف الخدمة 0x35).

الاستخدام

باستخدام الدالة Xxx_ReadDataLength، تطلب وحدة DCM من التطبيق تحديد طول بيانات أحد عناصر البيانات بالبايت وإرجاعه [SWS_Dcm_00796]. تم الإعلان عن الواجهة في ملف الترويسة Dcm_Externals.h ولها معرّف الخدمة 0x36 [SWS_Dcm_00796]. ويتم تنفيذ الاستعلام بشكل متزامن [SWS_Dcm_00796]. وعبر معامل الإخراج DataLength من النوع uint16*، يمرر التطبيق طول البايت للبيانات المراد قراءتها إلى DCM [SWS_Dcm_00796]. ولم تُحدد معاملات إدخال أو معاملات إدخال/إخراج [SWS_Dcm_00796]. وكقيمة مرجعة، تُرجع الدالة دائمًا E_OK من النوع Std_ReturnType [SWS_Dcm_00796].

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

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

تفاعل

إلى جانب الدالة المتزامنة، يوجد متغير غير متزامن يحمل الاسم نفسه مع معرّف الخدمة 0x4c، وهو متاح أيضًا عبر Dcm_Externals.h [SWS_Dcm_91010]. وبينما تستغني النسخة المتزامنة [SWS_Dcm_00796] عن حالة العملية، يتطلب النظير غير المتزامن معامل الإدخال OpStatus من النوع Dcm_OpStatusType [SWS_Dcm_91010]. بالإضافة إلى ذلك، يمكن للواجهة غير المتزامنة، إلى جانب E_OK، أن تقدم القيمة المرجعة DCM_E_PENDING إذا لم يكن الطلب قد اكتمل بعد ويتطلب المزيد من الاستدعاءات لإنهائه [SWS_Dcm_91010].

تطلب الدالة [SWS_Dcm_91010] (معرف الخدمة ID 0x4c) من التطبيق تحديد طول بيانات عنصر بيانات بالبايت. تم التصريح عنها في ملف الرأس Dcm_Externals.h وتخدم Diagnostic Communication Manager (DCM) للاستعلام المرن عن طول بيانات التشخيص.

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

عند الاستدعاء، تمرر وحدة DCM مستوى التقدم الحالي عبر معلمة الإدخال OpStatus من النوع Dcm_OpStatusType ([SWS_Dcm_91010]). ويكتب التطبيق نتيجة الاستعلام في معلمة الإخراج DataLength (النوع uint16*). وإذا لم يكن طول البيانات متاحًا على الفور، تشير الدالة عبر قيمة الإرجاع DCM_E_PENDING إلى أن المعالجة مستمرة وأن هناك حاجة لاستدعاءات إضافية ([SWS_Dcm_91010]). وبمجرد أن تصبح النتيجة جاهزة، يُبلغ التطبيق بالاكتمال عبر إرجاع E_OK.

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

وفقًا للمواصفة، صُنفت الدالة على أنها غير قابلة لإعادة الدخول ([SWS_Dcm_91010])، ولهذا السبب يجب استبعاد الاستدعاءات المتزامنة بواسطة DCM. وبما أن المواصفة لا تنص على قيم أخطاء محددة بخلاف DCM_E_PENDING، فمن المرجح أن يفترض DCM دائمًا وجود حجم بايت مضبوط بشكل صالح عند إرجاع E_OK. سؤال Q-e7ecd3a518e2cbcb (مفتوح)

تفاعل

تختلف الواجهة غير التزامنية [SWS_Dcm_91010] عن المتغير التزامني المرتبط [SWS_Dcm_00796] (معرف الخدمة ID 0x36). إذ لا تحتوي الأخيرة على المعلمة OpStatus، وتُنفذ تزامنيًا وتُرجع الطول دائمًا على الفور مع E_OK. أما [SWS_Dcm_91010] فتتيح للتطبيق، في المقابل، تمديد الحسابات المستغرقة للوقت بشكل غير تزامني عبر عدة دورات استدعاء.

تتوفر دالة النداء الخارجي التزامنية Xxx_ConditionCheckRead عبر ملف الترويسة Dcm_Externals.h، وتُستخدم للاستعلام من التطبيق عما إذا كانت شروط قراءة البيانات التشخيصية مستوفاة [SWS_Dcm_00797].

لا تحتوي الواجهة على معلمات إدخال وتشير إلى حالة الفحص عبر قيمة الإرجاع من النوع Std_ReturnType [SWS_Dcm_00797]:

• E_OK: كان الفحص ناجحًا، وشروط قراءة البيانات مستوفاة [SWS_Dcm_00797].
• E_NOT_OK: فشل الفحص، والقراءة غير مسموح بها [SWS_Dcm_00797].

إذا أرجعت الدالة E_NOT_OK، ترسل وحدة DCM استجابة سلبية (Negative Response) برمز الخطأ الذي مرره التطبيق عبر معلمة الإخراج ErrorCode (النوع Dcm_NegativeResponseCodeType*) [SWS_Dcm_00797].

فيما يتعلق بالتزامن، تم تحديد الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant) ويتم تنفيذها تزامنيًا بمعرف الخدمة 0x49 [SWS_Dcm_00797]. وعليه، يُفترض أن يتم تقييم الفحص من جانب التطبيق على الفور دون فترات انتظار حاجبة، لتجنب تأخير مستدعي DCM التزامني. سؤال Q-ada29c78c29d961e (مفتوح)

تمييزًا عن هذه العملية التزامنية، تحدد [SWS_Dcm_91011] متغيرًا غير تزامني تحت معرف الخدمة 0x37. يستخدم هذا المتغير بالإضافة إلى ذلك معلمة الإدخال OpStatus (النوع Dcm_OpStatusType) ويمكنه، إلى جانب E_OK وE_NOT_OK، إرجاع DCM_E_PENDING أيضًا إذا كانت الخطوات اللاحقة ضرورية لإنهاء الفحص [SWS_Dcm_91011].

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

يتم توفير الدالة Xxx_ConditionCheckRead عبر ملف الرأس Dcm_Externals.h وتُستخدم للاستعلام من برمجية التطبيق عما إذا كانت شروط قراءة بيانات التشخيص مستوفاة [SWS_Dcm_91011]. ويتم التنفيذ تحت معرف الخدمة ID 0x37 بشكل غير تزامني [SWS_Dcm_91011]. وعبر معلمة الإدخال OpStatus (النوع Dcm_OpStatusType)، يتم تمرير الحالة الحالية للعملية الجارية [SWS_Dcm_91011].

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

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

• E_OK: كان الطلب ناجحًا وشروط القراءة مستوفاة [SWS_Dcm_91011].
• E_NOT_OK: فشل الفحص [SWS_Dcm_91011]. في هذه الحالة، يجب على التطبيق ضبط رمز استجابة سلبية (NRC) من النوع Dcm_NegativeResponseCodeType عبر معلمة الإخراج ErrorCode؛ وترسل وحدة DCM بعد ذلك استجابة سلبية باستخدام هذا الـ NRC [SWS_Dcm_91011].
• DCM_E_PENDING: الفحص لم يكتمل بعد، لذا يلزم إجراء استدعاءات إضافية لإتمامه [SWS_Dcm_91011].

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

تم تحديد الواجهة على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_Dcm_91011]. وخلافًا لهذا المتغير غير التزامني، يُعرّف [SWS_Dcm_00797] تحت معرف الخدمة ID 0x49 توقيعًا تزامنيًا بدون معلمة OpStatus، والذي يُرجع حصرًا E_OK أو E_NOT_OK [SWS_Dcm_00797].

يتم توفير الواجهة غير التزامنية Xxx_GetScalingInformation عبر ملف الرأس Dcm_Externals.h وتُستخدم لطلب معلومات التحجيم لعنصر بيانات من التطبيق [SWS_Dcm_91012]. وتستدعي وحدة DCM هذه الدالة بمجرد استلام طلب تشخيص لخدمة UDS المسمّاة ReadScalingByIdentifier، وذلك لكل عنصر بيانات مهيأ للـ DID المطلوب [SWS_Dcm_00394].

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

تحدد الدالة المعلمات والدلالات التالية [SWS_Dcm_91012]:

• OpStatus (in): يمرر الحالة الحالية للعملية الجارية.
• ScalingInfo (out): ذاكرة تخزين مؤقت لاستيعاب معلومات التحجيم (scalingByte و scalingByteExtension).
• ErrorCode (out): يستوعب رمز الاستجابة السلبية في حال فشل العملية.

تم تحديد قيم الإرجاع بـ E_OK عند الإتمام الناجح، و E_NOT_OK عند حدوث خطأ، بالإضافة إلى DCM_E_PENDING في حال لم تكن المعالجة قد اكتملت بعد وتطلبت استدعاءات إضافية للإتمام [SWS_Dcm_91012].

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

إذا أرجع الاستدعاء E_NOT_OK، يجب على وحدة DCM إرسال استجابة سلبية يطابق رمز NRC الخاص بها القيمة المقدمة عبر معلمة الإخراج ErrorCode [SWS_Dcm_91012]. وقد حُددت الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_Dcm_91012]. تفسير: من المرجح أن يعتمد ما إذا كان سيتم استدعاء هذه الدالة غير التزامنية مع OpStatus أو المتغير التزامني المحدد كبديل بدون OpStatus [SWS_Dcm_00798] على تهيئة الـ DID المعني. سؤال Q-c4054a798f17a52c (مفتوح)

تُوفَّر الدالة Xxx_ReturnControlToECU عبر ملف الترويسة Dcm_Externals.h وتطلب من التطبيق إعادة التحكم في التحكم في الإدخال/الإخراج (IOControl) إلى وحدة التحكم الإلكترونية (ECU) [SWS_Dcm_01285]. يتم الاستدعاء بشكل متزامن ومحدد على أنه غير قابل لإعادة الدخول [SWS_Dcm_01285].

المعلمات والمتغيرات

يعتمد توقيع الدالة على تكوين قناع التحكم الخارجي [SWS_Dcm_01285]:

• إذا تم ضبط DcmDspDidControlMask على DCM_CONTROLMASK_EXTERNAL وكان حجم القناع يصل إلى أربعة بايتات (DcmDspDidControlMaskSize <= 0x04)، فسيتم تمرير معلمة الإدخال controlMask من النوع Dcm_ControlMask_{DID}Type [SWS_Dcm_01285].
• إذا كان حجم القناع خمسة بايتات أو أكثر (DcmDspDidControlMaskSize >= 0x05)، فسيتم استخدام المؤشر controlMask2 من النوع uint8* بدلاً من ذلك [SWS_Dcm_01285].
• عبر معلمة الإخراج ErrorCode (النوع Dcm_NegativeResponseCodeType*)، تنقل الدالة رمز الاستجابة السلبية المحدد (NRC) إلى DCM في حالة حدوث خطأ [SWS_Dcm_01285].

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

تُرجع الدالة الحالة Std_ReturnType. عند إعادة التحكم بنجاح، يبلغ التطبيق عن E_OK [SWS_Dcm_01285]. وإذا فشلت العملية، يجب أن تُرجع الدالة E_NOT_OK؛ وفي هذه الحالة ترسل وحدة DCM استجابة سلبية مصحوبة برمز NRC المخزن في ErrorCode إلى فاحص التشخيص [SWS_Dcm_01285].

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

تستدعي DCM واجهة الدالة المكوّنة (المعلمة DcmDspDataReturnControlToEcuFnc) عندما يتم تكوين DcmDspDataUsePort على USE_DATA_SYNCH_FNC أو USE_DATA_ASYNCH_FNC أو USE_DATA_ASYNCH_FNC_ERROR [SWS_Dcm_01435]. بالإضافة إلى إجراءات التشخيص المنتظمة، يتم استدعاء Xxx_ReturnControlToECU بواسطة DCM على وجه الخصوص عند الحاجة إلى إلغاء تسلسل تحكم IO نشط [SWS_Dcm_01435].

يتم توفير واجهة الدوال المتزامنة Xxx_ResetToDefault عبر ملف الرأس Dcm_Externals.h وتُستخدم لمطالبة أحد التطبيقات بإعادة تعيين تحكم الإدخال/الإخراج (IOControl) إلى القيمة الافتراضية [SWS_Dcm_01286].

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

تمتلك الدالة معرف الخدمة 0x4d، وتعمل بشكل متزامن، ومحددة على أنها غير قابلة لإعادة الدخول [SWS_Dcm_01286]. واعتمادًا على الحجم المكوَّن لقناع التحكم الخارجي، يتم تمرير إحدى معلمتي إدخال بديلتين:

• يُستخدم controlMask (النوع Dcm_ControlMask_{DID}Type) عندما يكون DcmDspDataUsePort مهيأً على USE_DATA_SYNCH_FNC، ويكون DcmDspDidControlMask مضبوطًا على DCM_CONTROLMASK_EXTERNAL، ولا يتجاوز DcmDspDidControlMaskSize قيمة 0x04 [SWS_Dcm_01286].
• يُستخدم controlMask2 (النوع uint8*) عندما يكون DcmDspDidControlMaskSize مهيأً بقيمة أكبر من أو تساوي 0x05 تحت نفس الشروط الحدية المتطابقة [SWS_Dcm_01286].

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

إذا كان من الممكن إجراء إعادة التعيين بنجاح، تُرجع الدالة E_OK [SWS_Dcm_01286]. وإذا فشلت العملية، يجب إرجاع E_NOT_OK. وفي هذه الحالة، يملأ التطبيق معلمة الإخراج ErrorCode (النوع Dcm_NegativeResponseCodeType*) برمز الاستجابة السلبية (NRC) المقابل، والذي تنقله وحدة DCM كاستجابة سلبية إلى جهاز الاختبار [SWS_Dcm_01286].

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

إذا كان النظام مصممًا لمعالجة الواجهات غير المتزامنة عبر USE_DATA_ASYNCH_FNC أو USE_DATA_ASYNCH_FNC_ERROR، فسيتم استخدام المتغير غير المتزامن مع المعلمة الإضافية OpStatus ومعرف الخدمة 0x3c بدلاً من هذه الدالة المتزامنة [SWS_Dcm_01314].

تطلب الدالة غير المتزامنة [SWS_Dcm_01314] من التطبيق إعادة تعيين تحكم الإدخال/الإخراج (IOControl) إلى قيمته الافتراضية. وهي معلنة في Dcm_Externals.h ولها معرف الخدمة 0x3c. ويتم التحكم في تقدم العملية عبر المعلمة OpStatus. وإذا لم تكن المعالجة قد اكتملت بعد، تُرجع الدالة DCM_E_PENDING، بينما يتم تأكيد الإكمال الناجح بـ E_OK.

اعتمادًا على التكوين وحجم القناع (DcmDspDidControlMaskSize حتى 4 بايت أو بدءًا من 5 بايت)، يتم بالإضافة إلى ذلك تمرير controlMask أو controlMask2 في حالة القناع الخارجي [SWS_Dcm_01314]. وإذا فشلت إعادة التعيين، تُرجع الدالة E_NOT_OK. وفي هذه الحالة، يجب تمرير رمز استجابة سلبية (NRC) عبر معلمة الإخراج ErrorCode، والذي ترسله وحدة DCM كاستجابة سلبية إلى جهاز الاختبار [SWS_Dcm_01314].

تم تحديد الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_Dcm_01314]. وتُستخدم عندما يتم ضبط DcmDspDataUsePort على USE_DATA_ASYNCH_FNC أو USE_DATA_ASYNCH_FNC_ERROR. بالنسبة لتكوينات الواجهة المتزامنة (USE_DATA_SYNCH_FNC)، يوجد بديل يتمثل في المتغير المتزامن بدون OpStatus [SWS_Dcm_01286].

الاستخدام

تُستخدم الدالة المتزامنة Xxx_FreezeCurrentState (المدرجة في كتالوج العناصر كـ Xxx_FreezeCurrentStateManager) لمطالبة التطبيق بتجميد الحالة الحالية للتحكم في الإدخال أو الإخراج (IOControl) [SWS_Dcm_01290]. تتوفر الدالة عبر ملف الترويسة Dcm_Externals.h ولديها معرّف الخدمة 0x4a AUTOSAR_SWS_DiagnosticCommunicationManager ص. 279. (تفسير: من المحتمل أن تعمل البادئة Xxx كعنصر نائب لوحدة التطبيق المعنية.) سؤال Q-f8c864cda732acc2 (مفتوح)

تعتمد معلمات الواجهة على تكوين قناع التحكم الخارجي (DcmDspDidControlMask على DCM_CONTROLMASK_EXTERNAL) [SWS_Dcm_01290]:

• controlMask (إدخال، النوع Dcm_ControlMask_{DID}Type): يتم تمريره إذا تم تكوين حجم القناع DcmDspDidControlMaskSize ليكون أقل من أو يساوي 4 بايتات (<= 0x04).
• controlMask2 (إدخال، النوع uint8*): يُستخدم بدلاً من ذلك إذا كان حجم القناع يشتمل على 5 بايتات على الأقل (=> 0x05).
• ErrorCode (إخراج، النوع Dcm_NegativeResponseCodeType*): مؤشر لتلقي رمز استجابة سلبية في حالة حدوث أخطاء.

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

تُرجع الدالة كـ Std_ReturnType إما E_OK عند التنفيذ الناجح أو E_NOT_OK إذا لم يكن الطلب ناجحًا [SWS_Dcm_01290]. في حالة حدوث خطأ وإرجاع E_NOT_OK، يجب على التطبيق إدخال رمز استجابة سلبية محدد (NRC) في المعلمة ErrorCode؛ وترسل وحدة DCM بعد ذلك استجابة تشخيص سلبية بهذا الرمز NRC AUTOSAR_SWS_DiagnosticCommunicationManager ص. 279.

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

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

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

تستدعي وحدة DCM الدالة غير المتزامنة Xxx_FreezeCurrentState لطلب تجميد الحالة الحالية للتحكم في الإدخال/الإخراج (IOControl) من برمجيات التطبيق [SWS_Dcm_01315]. يتوفر الإعلان عبر ملف الترويسة Dcm_Externals.h [SWS_Dcm_01315].

المعلمات وأقنعة التحكم

يتم الاستدعاء بالمعلمات التالية [SWS_Dcm_01315]:

• OpStatus: ينقل الحالة الحالية للعملية غير المتزامنة (Dcm_OpStatusType).
• controlMask أو controlMask2: إذا تم تكوين قناع التحكم خارجيًا (DcmDspDidControlMask == DCM_CONTROLMASK_EXTERNAL) واستُخدمت واجهة الدالة غير المتزامنة، تُمرر DCM المعلمة controlMask (من النوع Dcm_ControlMask_{DID}Type) لما يصل إلى 4 بايتات والمؤشر controlMask2 (uint8*) بدءًا من 5 بايتات، اعتمادًا على DcmDspDidControlMaskSize.
• ErrorCode: مؤشر إلى Dcm_NegativeResponseCodeType لإرجاع رمز خطأ.

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

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

• E_OK: اكتمل تجميد الحالة بنجاح.
• DCM_E_PENDING: الطلب لا يزال قيد المعالجة ويتطلب تغذيات لاحقة.
• E_NOT_OK: فشلت العملية. في هذه الحالة، ترسل DCM استجابة تشخيصية سلبية بقيمة NRC المحددة عبر ErrorCode.

التزامن

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

تطلب الدالة المتزامنة Xxx_ShortTermAdjustment من التطبيق تكييف إشارة إدخال/إخراج محددة مؤقتًا [SWS_Dcm_00802]. ويتم توفيرها عبر ملف الترويسة Dcm_Externals.h وتمتلك معرّف الخدمة 0x50 [SWS_Dcm_00802].

عبر المؤشر ControlStateInfo، تحصل الدالة على معلومات حالة التحكم من المعامل ControlOptionRecord لطلب التشخيص InputOutputControlByIdentifier [SWS_Dcm_00802]. وإذا تم تهيئة قناع تحكم خارجي (DcmDspDidControlMask == DCM_CONTROLMASK_EXTERNAL)، فسيتم بالاعتماد على DcmDspDidControlMaskSize تمرير إما controlMask (حتى 4 بايت) من النوع Dcm_ControlMask_{DID}Type أو controlMask2 (بدءًا من 5 بايت) كـ uint8* بشكل إضافي [SWS_Dcm_00802].

كقيمة مرجعة، تقدم العملية Std_ReturnType [SWS_Dcm_00802]:

• E_OK: تم تنفيذ تكييف إشارة الإدخال/الإخراج بنجاح [SWS_Dcm_00802].
• E_NOT_OK: فشل التكييف [SWS_Dcm_00802]. في هذه الحالة، يجب على التطبيق تعيين كود استجابة سلبية محدد (Dcm_NegativeResponseCodeType) عبر معامل الإخراج ErrorCode، والذي تعيد وحدة DCM إرساله في استجابة التشخيص السلبية إلى جهاز الفحص [SWS_Dcm_00802].

الدالة غير قابلة لإعادة الدخول (Non Reentrant) وتُستدعى بشكل متزامن [SWS_Dcm_00802]. يُستخدم هذا المتغير المتزامن عندما يكون عنصر البيانات مهيأً لاستدعاءات الدوال المتزامنة (DcmDspDataUsePort == USE_DATA_SYNCH_FNC) [SWS_Dcm_00802]. أما بالنسبة للمنافذ المهيأة بشكل غير متزامن (USE_DATA_ASYNCH_FNC أو USE_DATA_ASYNCH_FNC_ERROR)، فيوجد بالمقابل المتغير غير المتزامن ذو معرّف الخدمة 0x55 ومجموعة معاملات موسعة تتضمن OpStatus وDataLength [SWS_Dcm_01316].

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

يتم استدعاء الدالة [SWS_Dcm_01316] بواسطة Diagnostic Communication Manager (DCM) ويتم توفيرها عبر Dcm_Externals.h. وتطلب من التطبيق بشكل غير متزامن تعديل إشارة إدخال/إخراج في إطار خدمة التشخيص InputOutputControlByIdentifier. يتم تمرير بيانات التحكم عبر المؤشر ControlStateInfo (من المعلمة ControlOptionRecord)، مضافًا إليها طول البايت DataLength. ويتم التحكم في التسلسل عبر OpStatus: طالما استمر التعديل، يُرجع التطبيق DCM_E_PENDING؛ وبعد الإكمال بنجاح، يُبلغ عن E_OK.

المتغيرات ومعلمات القناع

في حالة التكوين الخارجي لقناع التحكم (DCM_CONTROLMASK_EXTERNAL)، يتم تمرير معلمات إضافية [SWS_Dcm_01316]:

• إذا كان حجم القناع أقل من أو يساوي 4 بايت، يتم تمرير controlMask من النوع Dcm_ControlMask_{DID}Type.
• إذا كان حجم القناع 5 بايت على الأقل، يتم بدلاً من ذلك تمرير controlMask2 كمؤشر إلى uint8.

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

إذا فشل التحكم في الإشارة، تُرجع الدالة E_NOT_OK وتعين رمز الاستجابة السلبية (NRC) عبر المؤشر ErrorCode، والذي ينقله DCM في الاستجابة السلبية [SWS_Dcm_01316]. وقد حُددت الدالة على أنها غير قابلة لإعادة الدخول.

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

تُستخدم الواجهة عندما يكون منفذ بيانات DID مهيأً على USE_DATA_ASYNCH_FNC أو USE_DATA_ASYNCH_FNC_ERROR ونوع البيانات على UINT8_DYN [SWS_Dcm_01316]. وهي تختلف عن المتغير المتزامن [SWS_Dcm_00802]، الذي لا يستخدم OpStatus ولا DataLength والمخصص للمنافذ المتزامنة ذات أنواع البيانات الثابتة.

تُستخدم الدالة Xxx_IsDidAvailable للتحقق غير المتزامن مما إذا كان معرّف التشخيص المطلوب (DID) متاحًا ضمن نطاق DID محدد [SWS_Dcm_00803]. ويتم توفيرها عبر ملف الترويسة Dcm_Externals.h وتمتلك معرّف الخدمة 0x53 [SWS_Dcm_00803].

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

يتم الاستدعاء بالمعلمات التالية [SWS_Dcm_00803]:

• DID (In): قيمة المعرّف المراد الاستعلام عنها لـ DID [SWS_Dcm_00803].
• OpStatus (In): الحالة الحالية للعملية للتحكم في الإجراء غير المتزامن [SWS_Dcm_00803].
• supported (Out): يوضح ما إذا كان DID متاحًا في النطاق؛ يشير DCM_DID_SUPPORTED إلى الدعم، بينما يشير DCM_DID_NOT_SUPPORTED إلى عدم الدعم [SWS_Dcm_00803].

الدلالات غير المتزامنة وقيم الإرجاع

نظرًا لأن الدالة تُنفذ بشكل غير متزامن، فقد يتطلب التحديد عدة خطوات استدعاء [SWS_Dcm_00803]. تشير القيمة المعادة DCM_E_PENDING إلى أن الطلب لم يكتمل بعد وأن هناك حاجة إلى استدعاءات إضافية لإكماله [SWS_Dcm_00803]. ويتم الإبلاغ عن القيمة المعادة E_OK عند اكتمال الفحص [SWS_Dcm_00803] (تفسير: من المحتمل أن يُنهي E_OK الاستعلام، وبعد ذلك يحتوي المعلمة supported على النتيجة الصالحة). سؤال Q-22c62d306a7ac4f1 (مفتوح)

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

تم تحديد الواجهة على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_Dcm_00803]. وبالتالي، فإن الاستدعاءات المتوازية لنفس DID أو لـ DIDs أخرى ضمن نفس النسخة غير مسموح بها.

الاستخدام وواجهة المعلمات

الدالة Xxx_ReadDidData (معرف الخدمة 0x40) متوفرة عبر Dcm_Externals.h وتطلب من التطبيق قيم بيانات معرف التشخيص (DID) [SWS_Dcm_00804]. يتم التمرير والإبلاغ عبر المعاملات التالية:

• DID: معرف معرّف البيانات (Data Identifier) المطلوب [SWS_Dcm_00804].
• Data: مؤشر إلى الذاكرة المؤقتة التي يجب نسخ بيانات الحمولة المقروءة إليها [SWS_Dcm_00804].
• OpStatus: حالة التقدم أو العملية للطلب الحالي [SWS_Dcm_00804].
• DataLength: طول البيانات المراد قراءتها [SWS_Dcm_00804].
• ErrorCode: معامل إخراج لاستقبال كود استجابة سلبية (NRC) [SWS_Dcm_00804].

الدلالات غير المتزامنة وقيم الإرجاع

تم تعريف الدالة على أنها غير متزامنة (Asynchronous) وتُرجع حالة من النوع Std_ReturnType [SWS_Dcm_00804]:

• E_OK: تمت قراءة البيانات بنجاح [SWS_Dcm_00804].
• DCM_E_PENDING: الطلب لم يكتمل بعد؛ يلزم إجراء استدعاءات إضافية للإكمال [SWS_Dcm_00804].
• E_NOT_OK: لم تكن العملية ناجحة [SWS_Dcm_00804].

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

إذا قدم التطبيق لـ Xxx_ReadDidData القيمة المرجعة E_NOT_OK، ترسل وحدة DCM استجابة سلبية مع كود NRC المعين عبر المعامل ErrorCode إلى جهاز اختبار التشخيص [SWS_Dcm_00804]. تم تحديد الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_Dcm_00804]. التفسير: نظرًا للمعالجة غير المتزامنة مع DCM_E_PENDING، فمن المرجح أن يتم الاستدعاء عادةً في سياق المهمة الدورية لـ DCM. سؤال Q-5e41e9fb7dc261b9 (مفتوح)

يتم استدعاء الدالة Xxx_WriteDidData بواسطة الوحدة DCM لطلب كتابة قيمة بيانات DID من التطبيق [SWS_Dcm_00805]. التصريح متاح عبر الترويسة Dcm_Externals.h [SWS_Dcm_00805].

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

يتم الاستدعاء بشكل غير متزامن ومحدد بأنه غير قابل لإعادة الدخول (Non Reentrant) [SWS_Dcm_00805]. عند الاستدعاء، يتم تمرير المعاملات التالية [SWS_Dcm_00805]:

• DID: معرف معرّف البيانات المراد كتابته.
• Data: مؤشر إلى الذاكرة المؤقتة التي تحتوي على البيانات المراد كتابتها.
• OpStatus: حالة العملية الحالية.
• DataLength: طول البيانات المراد كتابتها بالبايت.
• ErrorCode: معامل إخراج لرمز الاستجابة السلبية (NRC).

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

تُرجع الدالة Std_ReturnType كقيمة مرجعة بالمعاني التالية [SWS_Dcm_00805]:

• E_OK: تم تنفيذ أمر الكتابة بنجاح.
• DCM_E_PENDING: لم تكتمل العملية بعد؛ ويلزم إجراء استدعاءات إضافية لإتمامها.
• E_NOT_OK: لم تكن العملية ناجحة. في هذه الحالة، ترسل وحدة DCM استجابة سلبية مع قيمة NRC الممررة في معامل الإخراج ErrorCode.

تُستخدم الدالة Xxx_ReadDidRangeDataLength لمطالبة برمجيات التطبيق بإرجاع طول البيانات لنطاق DID (DID Range) [SWS_Dcm_01271]. وهي جزء من وحدة AUTOSAR Dcm، وتمتلك معرّف الخدمة 0x5e، وتتوفر عبر ملف الترويسة Dcm_Externals.h [SWS_Dcm_01271].

يتم الاستدعاء بدلالات غير متزامنة (Asynchronous) عبر معلمات الواجهة التالية [SWS_Dcm_01271]:

• DID (IN، uint16): يحدد معرّف البيانات الفعلي (Data ID value) لنطاق DID المطلوب [SWS_Dcm_01271].
• OpStatus (IN، Dcm_OpStatusType): يحدد حالة المعالجة الحالية للعملية قيد التشغيل [SWS_Dcm_01271].
• DataLength (OUT، uint16*): مؤشر إلى طول البيانات المراد قراءتها أو كتابتها [SWS_Dcm_01271].

تشير القيمة المعادة من النوع Std_ReturnType إلى نتيجة الاستعلام عن الطول [SWS_Dcm_01271]:

• E_OK: كان الطلب ناجحًا والطول المحسوب متاح [SWS_Dcm_01271].
• E_NOT_OK: لم يكن الطلب ناجحًا [SWS_Dcm_01271].
• DCM_E_PENDING: لم يكتمل التنفيذ بعد ويتطلب استدعاءات متتابعة إضافية لإتمامه [SWS_Dcm_01271].

فيما يتعلق بالتزامن، تم تحديد الواجهة على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_Dcm_01271].

تستدعي وحدة DCM الواجهة غير المتزامنة Xxx_GetInfotypeValueData بمجرد تلقي طلب تشخيص لـ OBD Service $09 ولا يكون InfoType المطلوب هو InfoType للتوافر (”availability InfoType“) [SWS_Dcm_00423]. لتوفير البيانات، تستدعي DCM جميع الدوال المكوّنة لـ InfoType هذا وتجمع القيم كاستجابة لـ Service $09 [SWS_Dcm_00423]. الإعلان متاح عبر Dcm_Externals.h [SWS_Dcm_91014].

يتم تمرير البيانات والإبلاغ عنها عبر معلمات مخزن مؤقت ومعلمات حالة محددة [SWS_Dcm_91014]:

• OpStatus (in): يعرض حالة التقدم الحالية للعملية الجارية.
• DataValueBuffer (out): مخزن مؤقت لاستيعاب بيانات الحمولة النافعة المحددة لـ InfoType.
• DataValueBufferSize (inout): يحتوي عند الاستدعاء على الحد الأقصى لحجم المخزن المؤقت القابل للكتابة بالبايتات، وتملؤه الدالة المستدعاة بعدد بايتات البيانات المكتوبة فعليًا.

كدالة غير متزامنة، تُرجع E_OK عند الاكتمال الناجح، أو E_NOT_OK عند حدوث أخطاء، أو DCM_E_PENDING إذا لم تكن العملية قد اكتملت بعد وتتطلب استدعاءات إضافية لإتمامها [SWS_Dcm_91014]. نظرًا لأن الدالة محددة على أنها غير قابلة لإعادة الدخول (Non Reentrant)، فلا يجوز إجراء أي استدعاءات متزامنة لنفس الدالة [SWS_Dcm_91014].

يتم الإعلان عن الدالة Xxx_Start عبر ملف الرأس Dcm_Externals.h وتطلب من برمجيات التطبيق بدء تنفيذ روتين تشخيصي [SWS_Dcm_01203]. تستدعي الوحدة DCM هذه الدالة بمجرد استلام طلب خدمة UDS لـ RoutineControl (0x31) مع الدالة الفرعية startRoutine والتحقق من صحته بنجاح [SWS_Dcm_00400]، أو عند ورود طلب RoutineControl مع OBDTestId لعدم التوفر [SWS_Dcm_01392].

تدعم الواجهة تنسيقات البيانات الثابتة والمتغيرة ويتم تشغيلها بشكل غير متزامن [SWS_Dcm_01203]:

• معلمات الإدخال: إشارات الإدخال الثابتة من dataIn_1 إلى dataIn_n أو بيانات متغيرة عبر مصفوفة البايت dataInVar بالإضافة إلى حالة العملية OpStatus [SWS_Dcm_01203].
• معلمات الإخراج: إشارات الإخراج الثابتة من dataOut_1 إلى dataOut_n أو بيانات الإخراج المتغيرة dataOutVar بالإضافة إلى رمز الخطأ ErrorCode لرسائل الاستجابة السلبية [SWS_Dcm_01203].
• معلمة الطول: تنقل معلمة الإدخال والإخراج currentDataLength عدد بايتات البيانات المفيدة في dataInVar أو dataOutVar في حالة طول البيانات المتغير [SWS_Dcm_01203].
• القيم المعادة: يؤكد E_OK البدء الناجح، ويبلغ E_NOT_OK عن الفشل، ويشير DCM_E_PENDING إلى خطوات معالجة لا تزال مستمرة، ويطلب DCM_E_FORCE_RCRRP إرسالًا مسبقًا لإشعار التعليق (NRC 0x78) [SWS_Dcm_01203].

فيما يتعلق بالتزامن، تم تحديد Xxx_Start على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_Dcm_01203]. في العمليات غير المتزامنة ذات القيمة المعادة DCM_E_PENDING، تستدعي وحدة DCM الدالة دوريًا مع OpStatus مستمر حتى تكتمل العملية [SWS_Dcm_01203].

إذا انتهت العملية بنجاح بـ E_OK، ترسل وحدة DCM استجابة UDS إيجابية مع البيانات المقدمة عبر dataOut كـ routineStatusRecord [SWS_Dcm_00401]. وإذا فشل التنفيذ بـ E_NOT_OK، يرسل DCM استجابة سلبية مع NRC المحدد في المعلمة ErrorCode [SWS_Dcm_01203]. وفي سياق روتينات OBD، يؤدي الحصول على قيمة معادة غير مساوية لـ E_OK إلى إرسال NRC 0x22 [SWS_Dcm_01394].

الاستخدام

توضح الدالة Xxx_StartConfirmation بشكل ملزم، وفقًا لـ [SWS_Dcm_91016]، إرسال استجابة لطلب StartRoutine سابق. تم التصريح عن الواجهة في ملف الرأس Dcm_Externals.h وتتمتع بدلالات تنفيذ تزامنية ([SWS_Dcm_91016]). وكعامل إدخال وحيد، يتم تمرير ConfirmationStatus من النوع Dcm_ConfirmationStatusType، والذي يصف حالة تأكيد نقل الروتين. ولا توجد معلمات إدخال وإخراج إضافية وفقًا للمواصفة ([SWS_Dcm_91016]).

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

تُرجع الدالة قيمة حالة من النوع Std_ReturnType كقيمة إرجاع ([SWS_Dcm_91016]). وتؤكد القيمة E_OK التنفيذ الناجح للطلب، في حين تشير E_NOT_OK إلى معالجة غير ناجحة. ولا توجد رموز خطأ محددة أو بلاغات صريحة إلى Development Error Tracer (DET) أو Diagnostic Event Manager (DEM) معرفة في حمولة البيانات (Payload) لهذه الدالة.

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

فيما يخص التزامن، تم تصنيف Xxx_StartConfirmation على أنها غير قابلة لإعادة الدخول (Non Reentrant) ([SWS_Dcm_91016]). ويتطلب ذلك من المتصل تجنب التنفيذ المتزامن أو المتداخل بشكل صارم. تفسير: من المرجح أن يتم استدعاء الدالة بواسطة DCM لإخطار تنفيذ الروتين من جانب التطبيق باكتمال عملية الإرسال. سؤال Q-be2dafd63bf2a9a5 (مفتوح)

الاستخدام

يستدعي DCM الدالة [SWS_Dcm_01204] لإنهاء تنفيذ روتين تشخيص قيد التشغيل في التطبيق. ويتم الاستدعاء ضمن إطار خدمة UDS المسماة RoutineControl (0x31) بالوظيفة الفرعية stopRoutine بمجرد اكتمال الفحوصات المسبقة المطلوبة بنجاح [SWS_Dcm_00402]. تمتلك الواجهة معرّف الخدمة 0x5c ومُعلنة عبر ملف الترويسة Dcm_Externals.h [SWS_Dcm_01204].

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

اعتمادًا على تكوين الروتين، يمرر DCM بيانات إدخال ثابتة أو متغيرة (dataIn_1 إلى dataIn_n أو dataInVar) ومراجع ذاكرة التخزين المؤقت لبيانات الإخراج (dataOut_1 إلى dataOut_n أو dataOutVar) [SWS_Dcm_01204]، [SWS_Dcm_00402]. وفي حالة طول البيانات المتغير، يحتوي currentDataLength على عدد بايتات بيانات الإدخال أو الإخراج [SWS_Dcm_01204]. وقد حُددت كقيم إرجاع لـ Std_ReturnType:

• E_OK: تم إنهاء الروتين بنجاح؛ يرسل DCM استجابة UDS إيجابية تتضمن بيانات الإخراج الناتجة كـ routineStatusRecord [SWS_Dcm_01204]، [SWS_Dcm_00403].
• E_NOT_OK: فشل إلغاء الروتين؛ يرسل DCM استجابة UDS سلبية تتضمن الـ NRC المحفوظ في ErrorCode [SWS_Dcm_01204].
• DCM_E_PENDING: العملية لا تزال قيد المعالجة؛ يستدعي DCM الدالة مجددًا للإتمام [SWS_Dcm_01204].
• DCM_E_FORCE_RCRRP: يطلب التطبيق من DCM إرسال استجابة معلقة (NRC 0x78) [SWS_Dcm_01204].

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

تم تحديد العملية على أنها غير متزامنة وغير قابلة لإعادة الدخول (Non Reentrant) [SWS_Dcm_01204]. وإذا حدث خطأ أثناء التنفيذ، يجب على التطبيق كتابة Dcm_NegativeResponseCodeType المناسب في المعلمة ErrorCode وإرجاع E_NOT_OK [SWS_Dcm_01204].

تُستخدم الدالة التزامنية Xxx_StopConfirmation للإشارة إلى إرسال استجابة لطلب StopRoutine سابق [SWS_Dcm_91017]. وعند الاستدعاء، يمرر النظام عبر معلمة الإدخال ConfirmationStatus من النوع Dcm_ConfirmationStatusType حالة التأكيد المحددة لإنهاء الروتين [SWS_Dcm_91017]. وكقيمة إرجاع، تقدم الواجهة قيمة من النوع Std_ReturnType: حيث يشير E_OK هنا إلى أن الطلب قد تمت معالجته بنجاح، بينما تشير E_NOT_OK إلى طلب غير ناجح [SWS_Dcm_91017].

فيما يتعلق بالتزامن وشروط الاستدعاء، تم تحديد الواجهة على أنها غير قابلة لإعادة الدخول (Non Reentrant) ولها معرف الخدمة ID 0x69 [SWS_Dcm_91017]. ويتم توفير التصريح عبر ملف الرأس Dcm_Externals.h [SWS_Dcm_91017]. تفسير: استنادًا إلى توفيرها عبر Dcm_Externals.h والبادئة القابلة للتخصيص Xxx_، فمن المرجح أن يتم استدعاء الدالة بواسطة وحدة DCM ويتم تنفيذها بواسطة مكون برمجي خاص بالتطبيق أو معالج الروتين المسؤول. سؤال Q-743e69ff8cf92321 (مفتوح)

لم يتم تحديد رموز خطأ خاصة أو إخطارات لـ Development Error Tracer (DET) أو Diagnostic Event Manager (DEM) في المتطلبات. ويقتصر السلوك في حالة الخطأ رسميًا على مستوى هذه الواجهة على إرجاع قيمة الخطأ E_NOT_OK إذا لم يمكن إتمام المعالجة بنجاح [SWS_Dcm_91017].

تستدعي وحدة DCM الدالة [SWS_Dcm_91013] للاستعلام عن نتيجة تنفيذ روتين من التطبيق. يحدث هذا في إطار خدمة UDS المعنونة RoutineControl (0x31) مع الوظيفة الفرعية requestRoutineResults بمجرد اجتياز جميع عمليات الفحص من جانب الإدخال بنجاح [SWS_Dcm_00404]. تتوفر الواجهة عبر Dcm_Externals.h، وتعمل بشكل غير متزامن ومحددة على أنها غير قابلة لإعادة الدخول [SWS_Dcm_91013].

تتحكم وحدة DCM في سير العملية عبر المعلمة OpStatus. تستقبل الدالة بيانات إدخال ثابتة (من dataIn_1 إلى dataIn_n) أو بيانات متغيرة (dataInVar) مشتقة من routineControlOptionRecord [SWS_Dcm_00404]. وعبر معلمات إخراج ثابتة (من dataOut_1 إلى dataOut_n) أو مخازن مؤقتة متغيرة للإخراج (dataOutVar وvariableDataLength)، يمرر التطبيق بيانات النتيجة إلى DCM [SWS_Dcm_91013].

إذا اكتمل الاستعلام بنجاح باستخدام E_OK، تقوم وحدة DCM بتجميع بيانات الإخراج استنادًا إلى معلمة التكوين DcmDspRequestRoutineResultsOut في routineStatusRecord وترسل استجابة إيجابية [SWS_Dcm_00405]. إذا كانت العملية لا تزال جارية، يمكن للتطبيق إرجاع DCM_E_PENDING للاستدعاءات اللاحقة أو DCM_E_FORCE_RCRRP لإرسال استجابة مؤقتة (NRC 0x78) [SWS_Dcm_91013].

في حالة حدوث خطأ، تُرجع الدالة E_NOT_OK وتعين ErrorCode إلى قيمة NRC المناسبة، وعندئذٍ ترسل وحدة DCM استجابة سلبية مطابقة [SWS_Dcm_91013]. نظرًا لأن الدالة غير قابلة لإعادة الدخول، فلا يجوز استدعاؤها بشكل متوازٍ لنفس الروتين [SWS_Dcm_91013].

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

تخدم الدالة Xxx_RequestResultsConfirmation تأكيد استجابة تشخيص منقولة لطلب RequestRoutineResults [SWS_Dcm_91018]. تم التصريح عنها في ملف الرأس Dcm_Externals.h ولديها معرف الخدمة ID 0x70 [SWS_Dcm_91018]. وعبر معلمة الإدخال ConfirmationStatus من النوع Dcm_ConfirmationStatusType، يتلقى التنفيذ معلومات حول الحالة التي اكتمل بها إرسال نتائج الروتين [SWS_Dcm_91018]. يُنفذ الاستدعاء تزامنيًا ويُرجع Std_ReturnType، حيث يشير E_OK إلى معالجة ناجحة وE_NOT_OK إلى الفشل [SWS_Dcm_91018].

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

وفقًا للمواصفة، صُنفت الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_Dcm_91018]. ولذلك، يجب ألا تحدث استدعاءات متزامنة لنفس النسخة المثيلة. تفسير: يتم الاستدعاء بواسطة وحدة DCM بشكل متسلسل في سياق تأكيد الاستجابة، ولهذا السبب ينبغي تنفيذ الدالة دون عمليات حاجزة (blocking). سؤال Q-935a06744e7b9af7 (مفتوح)

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

تقتصر معالجة الأخطاء على القيمة المرجعة E_NOT_OK، نظراً لأن أخطاء التطوير المنفصلة (DET) أو أخطاء الإنتاج (DEM) غير محددة لهذا الاستدعاء [SWS_Dcm_91018]. تفسير: تعمل الدالة كنقطة نهاية تأكيد خاصة بالتطبيق (Callback) لـ DCM، لمزامنة اكتمال طلب التشخيص على مستوى المستخدم بعد إرسال نتائج الإجراء الروتيني. سؤال Q-d3dd0142a30e1363 (مفتوح)

تُستخدم الدالة Xxx_RequestControl لتنفيذ وظيفة تحكم محددة لـ TID وتُستخدم عادةً لتنفيذ OBD Service $08 ([SWS_Dcm_01338]). تستدعي وحدة DCM الدالة المكوّنة بشكل متزامن بمجرد تلقي طلب OBD Service $08 لا يمثل معرّف الاختبار الخاص به (TID) معرّف TID للتوافر (”availability TID“) ([SWS_Dcm_00419]). يتم توفير إعلان الواجهة عبر ملف الترويسة Dcm_Externals.h ([SWS_Dcm_01338]).

المعلمات ومعالجة المخزن المؤقت

• InBuffer: مؤشر إلى بيانات الحمولة النافعة لطلب OBD المستلم. يجب أن يتطابق عدد بايتات بيانات الإدخال هذه تمامًا مع الحجم المكوّن في وحدة DCM ([SWS_Dcm_00419]، [SWS_Dcm_01338]).
• OutBuffer: مؤشر إلى المخزن المؤقت للإخراج الذي تضع فيه وظيفة التحكم المستدعاة نتائجها. حجم المخزن المؤقت محدد مسبقًا بشكل ثابت ومأخوذ من تكوين وحدة DCM ([SWS_Dcm_00419]، [SWS_Dcm_01338]).

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

تُرجع الدالة كقيمة حالة Std_ReturnType: تشير القيمة E_OK إلى معالجة ناجحة، بينما تشير E_NOT_OK إلى حالة خطأ ([SWS_Dcm_01338]). إذا أرجعت Xxx_RequestControl نتيجة غير E_OK، تستجيب وحدة DCM برمز الاستجابة السلبية NRC 0x22 (Conditions Not Correct) تجاه فاحص التشخيص ([SWS_Dcm_01192]).

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

تم تحديد الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant) ولها معرّف الخدمة 0x63 ([SWS_Dcm_01338]).

يتم توفير دالة رد النداء (Callback) Xxx_StartProtocol عبر ملف الرأس Dcm_Externals.h وتتيح للتطبيق، عند الطلب الأول لبروتوكول تشخيصي، فحص الشروط البيئية الحالية والموافقة على متابعة معالجة البروتوكول أو رفضها [SWS_Dcm_01339].

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

يتم الاستدعاء بواسطة الوحدة الفرعية DSL التابعة لـ DCM بشكل متزامن وغير قابل لإعادة الدخول لجميع الدوال المهيأة [SWS_Dcm_00036]، [SWS_Dcm_01339]. ويتم تمرير معلمات الإدخال التالية إلى الدالة [SWS_Dcm_01339]:

• ProtocolType: نوع بروتوكول التشخيص المراد بدء تشغيله،
• TesterSourceAddress: عنوان المصدر لجهاز الاختبار الطالب،
• ConnectionId: المعرف الفريد للاتصال.

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

كقيمة إرجاع، تقدم الدالة Std_ReturnType مع E_OK عند نجاح الموافقة، و E_NOT_OK عند عدم نجاح الفحص، أو E_PROTOCOL_NOT_ALLOWED إذا كان البروتوكول غير مسموح به [SWS_Dcm_01339]. وإذا لم تُرجع دالة واحدة على الأقل من دوال Xxx_StartProtocol المهيأة القيمة E_OK، يُلغي DCM بدء البروتوكول ويستجيب بـ NRC 0x22 [SWS_Dcm_00674].

التهيئة بعد نجاح الموافقة

فقط عندما تُرجع جميع ردود النداء (callbacks) Xxx_StartProtocol المهيأة القيمة E_OK، ينفذ DCM خطوات التهيئة الإضافية:

• تحميل معلمات التوقيت القياسية من تهيئة الجلسة الافتراضية (Default Session) [SWS_Dcm_00144]،
• تفعيل جدول الخدمة [SWS_Dcm_00145]،
• إعادة تعيين حالة الأمان (Security State) [SWS_Dcm_00146]،
• إعادة تعيين حالة الجلسة إلى جلسة التشخيص الافتراضية، بالإضافة إلى تنفيذ تغيير الوضع عبر SchM_Switch_<bsnp>_DcmDiagnosticSessionControl إلى RTE_MODE_DcmDiagnosticSessionControl_DEFAULT_SESSION [SWS_Dcm_00147].

تُخطر دالة رد النداء التزامنية Xxx_StopProtocol التطبيق بإنهاء بروتوكول تشخيصي ([SWS_Dcm_01340]). ويتم التصريح عنها عبر ملف الرأس Dcm_Externals.h، كما تم تحديدها على أنها غير قابلة لإعادة الدخول (Non Reentrant) ([SWS_Dcm_01340]).

يتم إطلاق استدعاء جميع دوال Xxx_StopProtocol المهيأة (المهيأة عبر المعلمة DcmDslCallbackDCMRequestService) بواسطة الوحدة الفرعية DSL في سيناريوهات الأسبقية (Preemption) التالية:

• تتم إزاحة طلب تشخيصي قيد التشغيل بواسطة طلب ذي أولوية أعلى لبروتوكول آخر ([SWS_Dcm_00459]).
• يزيح طلب ذو أولوية أقل أو متساوية بروتوكولاً ذا أولوية أعلى، طالما كان الأخير في الجلسة الافتراضية (Default Session) ولا يوجد طلب نشط في مرحلة التنفيذ ([SWS_Dcm_00625]).

عند الاستدعاء، يتم تمرير نوع البروتوكول (ProtocolType)، وعنوان مصدر جهاز الفحص (TesterSourceAddress)، بالإضافة إلى معرف الاتصال (ConnectionId) ([SWS_Dcm_01340]). وكتعليمات إرجاع، تُرجع الدالة E_OK في حالة التنفيذ الناجح أو E_NOT_OK ([SWS_Dcm_01340]). إذا لم تُرجع الدالة E_OK، يستجيب DCM برمز الاستجابة السلبية NRC 0x22 ([SWS_Dcm_01190]).

يتم الإعلان عن الدالة التزامنية وغير القابلة لإعادة الدخول Xxx_Indication عبر ملف الترويسة Dcm_Externals.h [SWS_Dcm_01341]. تشير للتطبيق إلى التنفيذ الوشيك لخدمة تشخيصية وتتيح له رفض تنفيذ طلب الخدمة [SWS_Dcm_01341]. يتم الاستدعاء تزامنيًا بواسطة الوحدة الفرعية DSD على جميع منافذ ServiceRequestIndication المهيأة، عند وجود حاويات التكوين DcmDsdServiceRequestManufacturerNotification [SWS_Dcm_00218] أو DcmDsdServiceRequestSupplierNotification [SWS_Dcm_00516].

تُمرر كمعلمات إدخال معرف الخدمة (SID)، وبيانات الطلب بدون SID (RequestData، DataSize)، ونوع العنونة (ReqType)، ومعرف الاتصال (ConnectionId)، ونوع البروتوكول (ProtocolType)، وعنوان المصدر الخاص بجهاز الفحص (TesterSourceAddress) [SWS_Dcm_01341].

من خلال قيمة الإرجاع من النوع Std_ReturnType، يتحكم التطبيق في رد فعل الوحدة الفرعية DSD [SWS_Dcm_01341]:

• E_OK: كان الطلب ناجحًا وتتم متابعة معالجته بشكل نظامي [SWS_Dcm_01341].
• E_REQUEST_NOT_ACCEPTED: لا يتم قبول الطلب. إذا أرجعت دالة إشارة (Indication) واحدة على الأقل تم استدعاؤها القيمة E_REQUEST_NOT_ACCEPTED، تكتم الوحدة الفرعية DSD أي استجابة لجهاز الفحص [SWS_Dcm_00462]، [SWS_Dcm_00517].
• E_NOT_OK: لم يكن الطلب ناجحًا. يكتب التطبيق في هذه الحالة رمز استجابة سلبية في معلمة الإخراج ErrorCode [SWS_Dcm_01341]. ما لم يُرجع أي استدعاء E_REQUEST_NOT_ACCEPTED، ترسل الوحدة الفرعية DSD استجابة سلبية برمز NRC هذا [SWS_Dcm_00463]، [SWS_Dcm_00518].

إذا أرجعت عدة دوال E_NOT_OK ولم تُرجع أي دالة E_REQUEST_NOT_ACCEPTED عند تهيئة عدة إخطارات، تستخدم الوحدة الفرعية DSD للاستجابة السلبية إلزاميًا ErrorCode الخاص بأول دالة تستجيب بـ E_NOT_OK [SWS_Dcm_01321]، [SWS_Dcm_01322].

تُستخدم دالة رد النداء Xxx_Confirmation لإبلاغ التطبيق تزامنيًا باكتمال إرسال تشخيصي — إما الإرسال الناجح أو حدوث خطأ في الإرسال — ([SWS_Dcm_01342]). يتم توفير الإعلان عبر ملف الترويسة Dcm_Externals.h ([SWS_Dcm_01342]).

عند الاستدعاء بواسطة الوحدة الفرعية DCM المسماة DSD (Diagnostic Service Dispatcher)، يتم تمرير بيانات السياق الأساسية لأمر التشخيص ([SWS_Dcm_01342]، [SWS_Dcm_00741]):

• SID: معرف الخدمة التشخيصية ([SWS_Dcm_01342]).
• ReqType: نوع العنونة (0 للعنونة الفيزيائية، 1 للعنونة الوظيفية) ([SWS_Dcm_01342]).
• ConnectionId وProtocolType وTesterSourceAddress: سمات الاتصال والبروتوكول الفريدة بالإضافة إلى عنوان المصدر الخاص بجهاز الفحص ([SWS_Dcm_01342]).
• ConfirmationStatus: معلومات الحالة حول نجاح الإرسال أو خطئه ([SWS_Dcm_01342]).

كقيمة إرجاع، تقدم العملية Std_ReturnType (E_OK عند المعالجة الناجحة للتأكيد، وإلا E_NOT_OK) ([SWS_Dcm_01342]). تستدعي DSD الدالة على جميع المنافذ التي تستخدم الواجهة ServiceRequestNotification (المهيأة عبر DcmDsdServiceRequestManufacturerNotification أو DcmDsdServiceRequestSupplierNotification) ([SWS_Dcm_00741]).

فيما يتعلق بترتيب الاستدعاء، يتم تنفيذ Xxx_Confirmation نظاميًا مباشرة في أعقاب DspInternal_DcmConfirmation() ([SWS_Dcm_00742]). ومع ذلك، إذا كانت الحالة الخاصة وفقًا لـ [SWS_Dcm_01172] موجودة، فإن DSD تستدعي فقط Xxx_Confirmation، بينما يُلغى الاستدعاء الداخلي.

نظرًا لتحديد Xxx_Confirmation على أنها غير قابلة لإعادة الدخول (Non Reentrant) وتزامنية ([SWS_Dcm_01342])، يُفترض ألا يتضمن تنفيذ جانب التطبيق أي عمليات حاجبة وألا يطلق أي استدعاءات عودية قابلة لإعادة الدخول إلى DCM (Interpretation). سؤال Q-58ce3e44dc61540b (مفتوح)

الاستخدام

تتوفر دالة الاستدعاء الخارجي (Callout) المتزامنة Xxx_ClearDTCCheckFnc للتطبيق عبر ملف الترويسة Dcm_Externals.h [SWS_Dcm_01270]. وتُستخدم للتحقق الخاص بالشركة المصنعة والمورّد من الشروط قبل مسح مجموعة مطلوبة من رموز أخطاء التشخيص (Group of DTC). وتُمرر إليها كمعلمة إدخال المعرّف GoDTC من النوع uint32، والذي يحدد مجموعة رموز الأخطاء المراد مسحها [SWS_Dcm_01270].

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

تتم الموافقة على طلب المسح عبر قيمة الإرجاع من النوع Std_ReturnType بالتكامل مع معلمة الإخراج ErrorCode [SWS_Dcm_01270]:

• E_OK: يسمح التطبيق بمسح مجموعة رموز الأخطاء المطلوبة GoDTC [SWS_Dcm_01270].
• E_NOT_OK: يمنع التطبيق مسح المجموعة. في حالة الخطأ هذه، يجب تعيين رمز استجابة سلبي عبر معلمة الإخراج ErrorCode من النوع Dcm_NegativeResponseCodeType*. وترسل الوحدة DCM بعد ذلك استجابة سلبية تتضمن قيمة NRC المحددة في ErrorCode [SWS_Dcm_01270].

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

زُوّدت الدالة بمعرّف الخدمة 0x5f، وتعمل بشكل متزامن، ومُعرّفة على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_Dcm_01270]. لذلك، يجب أن يضمن سياق الاستدعاء تنفيذ الاستدعاءات بالتتابع ودون تداخلات متزامنة.

يتم استدعاء دالة النداء الخارجي Xxx_ProcessRequestDownload ([SWS_Dcm_00754]) بواسطة الوحدة Dcm لبدء عملية تنزيل أثناء معالجة خدمة UDS المسماة RequestDownload. تم تعريفها بأنها غير تزامنية وغير قابلة لإعادة الدخول، وتتوفر عبر ملف الترويسة Dcm_Externals.h ([SWS_Dcm_00754]).

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

يتم الاستدعاء تدريجيًا عبر المعلمة OpStatus بالقيم DCM_INITIAL، أو DCM_PENDING، أو DCM_CANCEL ([SWS_Dcm_00754]). وتُمرر كمعلمات إدخال طرق الضغط والتشفير (DataFormatIdentifier)، وكتلة الذاكرة (MemoryIdentifier)، وعنوان البداية (MemoryAddress)، وحجم الذاكرة غير المضغوط بالبايت (MemorySize) ([SWS_Dcm_00754]). قبل الاستدعاء، يكتب Dcm في معلمة الدخل/الخرج BlockLength أقصى حجم ممكن للمخزن المؤقت ([SWS_Dcm_01417]). تقوم الدالة بضبط هذه القيمة لتناسب أقصى طول كتلة مسموح به لعمليات الكتابة اللاحقة ([SWS_Dcm_00754]).

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

ترجع الدالة E_OK عند التنفيذ الناجح، أو DCM_E_PENDING إذا كانت المعالجة لا تزال مستمرة، أو E_NOT_OK في حالة حدوث خطأ ([SWS_Dcm_00754]):

• إذا أرجع الاستدعاء E_OK وكانت القيمة المتفاوض عليها BlockLength أصغر من أو تساوي طول المخزن المؤقت المدعوم لاتصال البروتوكول الحالي، ترسل Dcm استجابة إيجابية بهذه القيمة كـ maxNumberOfBlockLength ([SWS_Dcm_01419]).
• إذا تجاوز طول المخزن المؤقت المُرجع حجم المخزن المؤقت المدعوم لاتصال البروتوكول، تبلغ Dcm عن خطأ DET المسجل كـ DCM_E_INTERFACE_BUFFER_OVERFLOW ([SWS_Dcm_01418]).
• عند إرجاع E_NOT_OK، ترسل Dcm استجابة UDS سلبية (NRC) بالقيمة المحددة في معلمة الإخراج ErrorCode ([SWS_Dcm_00754]، [SWS_Dcm_00757]).

تستدعي وحدة DCM دالة الاستدعاء الخارجي (Callout) Xxx_ProcessRequestTransferExit لإنهاء عملية تنزيل أو تحميل جارية في إطار خدمة UDS المسماة RequestTransferExit [SWS_Dcm_00755]. يتم توفير التصريح عن الواجهة عبر الترويسة Dcm_Externals.h [SWS_Dcm_00755].

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

تعمل الدالة بشكل غير متزامن ومحددة بأنها غير قابلة لإعادة الدخول (non reentrant) [SWS_Dcm_00755]. يتم الاستدعاء مع تمرير حالة التنفيذ الحالية OpStatus (القيم الممكنة: DCM_INITIAL أو DCM_PENDING أو DCM_CANCEL) [SWS_Dcm_00755]. تم تحديد القيم المرجعة التالية من النوع Std_ReturnType:

• E_OK: تم إنهاء النقل بنجاح [SWS_Dcm_00755].
• DCM_E_PENDING: إنهاء النقل لم يكتمل بعد ويتطلب استدعاءات لاحقة [SWS_Dcm_00755].
• E_NOT_OK: فشل الإنهاء أو أن ذاكرة الاستجابة المؤقتة صغيرة جدًا [SWS_Dcm_00755].

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

إذا أرجعت العملية Xxx_ProcessRequestTransferExit قيمة الخطأ E_NOT_OK، فيجب تمرير كود استجابة سلبية عبر معامل الإخراج ErrorCode. بعد ذلك، ترسل وحدة DCM استجابة UDS سلبية (NRC) مع كود الخطأ هذا تحديدًا إلى جهاز فحص التشخيص [SWS_Dcm_00759]. في حالة استدعاء الإلغاء، تمرر وحدة DCM الحالة DCM_CANCEL إلى الدالة [SWS_Dcm_00755].