يوفر Negative Response Codes خاصة بـ UDS للمعالجة المعيارية للأخطاء في وظائف التشخيص.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: ee46722aaae6المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
يوفر Negative Response Codes خاصة بـ UDS للمعالجة المعيارية للأخطاء في وظائف التشخيص.
يغلف مجال الخطأ ara::diag::DiagUdsNrcErrorDomain رموز الأخطاء الناتجة عن معالجة التشخيص ويربطها بقيم أخطاء UDS المعيارية [SWS_DM_00529]. عندما يُبلغ معالج تشخيص خارجي عن خطأ مطابق، يشتق Diagnostic Server منه NRC بحجم 1 بايت ويرسل استجابة UDS سلبية إلى جهاز الفحص [SWS_DM_02060]. كشرط حدي أساسي، يجب أن تقع قيم NRC المشتقة بشكل صارم ضمن نطاق القيم بين 0x01 و0xFE.
السياق
يمثل الصنف ara::diag::DiagUdsNrcErrorDomain مجال الخطأ المعياري للأخطاء التي تنشأ من أصناف تشخيص مختلفة (AUTOSAR_AP_SWS_Diagnostics §8.12.3 «Class: DiagUdsNrcErrorDomain»). وبصفته تخصيصًا للصنف الأساسي ara::core::ErrorDomain[SWS_DM_00529]، فإنه يشكل حلقة الوصل الأساسية بين معالجة التشخيص من جانب التطبيق وبروتوكول UDS (Unified Diagnostic Services). وضمن AUTOSAR Adaptive Platform، يتوسط بين معالجات التشخيص الخارجية أو تطبيقات البرمجيات وDiagnostic Server (Diagnostic Management, DM). إذا أبلغ معالج تشخيص خارجي عن خطأ ينتمي إلى هذا المجال أثناء تنفيذ الأمر، تقوم Diagnostic Server Instance بتقييمه بشكل مستهدف [SWS_DM_02060]. بالإضافة إلى ذلك، يتفاعل المجال مع فحص الظروف البيئية القابلة للتهيئة في حال فشلت قراءة عناصر البيانات [SWS_DM_00970].
دورة الحياة
يتم إنشاء مثيل من ara::diag::DiagUdsNrcErrorDomain عبر المنشئ الافتراضي constexpr DiagUdsNrcErrorDomain() noexcept[SWS_DM_00532]. تم تحديد هذا المنشئ على أنه آمن من الاستثناءات وآمن مؤشريًا [SWS_DM_00532]. نظرًا لتصميم constexpr وطبيعة مجالات الخطأ الخالية من الوظائف، فمن المرجح عادةً توفير مثيل ككائن غير قابل للتغيير على مستوى العملية بأكملها (تفسير). سؤال Q-72b7b9c623c1efe0 (مفتوح) كما أن دوال الفحص التأسيسية Name()[SWS_DM_00533] وMessage()[SWS_DM_00534] آمنة مؤشريًا وآمنة من الاستثناءات. ونظرًا لأن الكائن لا يدير حالة متغيرة، فإن دورة حياته ترتبط بسياق وقت التشغيل الكلي لتطبيق التشخيص وتسمح بوصول متزامن للقراءة دون قيود.
مسار الاستخدام
يصف مسار الاستخدام النموذجي الإشارة إلى خطأ تشخيص وتحويله أثناء تنفيذ إحدى الخدمات:
ينفذ معالج تشخيص خارجي وظيفة تشخيص ويكتشف شرط خطأ.
ينشئ التطبيق ara::core::Result مع رمز خطأ لمجال ara::diag::DiagUdsNrcErrorDomain باستخدام النوع Errc (اسم بديل لـ DiagUdsNrcErrc) [SWS_DM_00530] ويُرجعه إلى Diagnostic Server Instance [SWS_DM_02060].
تستقبل Diagnostic Server Instance القيمة المرجعة وتتعرف على وجود مجال الخطأ ara::diag::DiagUdsNrcErrorDomain[SWS_DM_02060].
يشتق DM رمز UDS-NRC من رمز الخطأ DiagUdsNrcErrc، على سبيل المثال عبر static_cast إلى قيمة NRC بحجم 1 بايت [SWS_DM_02059].
يرد Diagnostic Server على جهاز فحص التشخيص الطالب باستجابة UDS سلبية (negative response) تحمل قيمة NRC المشتقة [SWS_DM_02060].
تُطبق معالجة خاصة على طلبات Multi-DID: على الرغم من أن حدوث خطأ من ara::diag::DiagUdsNrcErrorDomain في النتيجة يشير إلى فشل معالج التشخيص الخارجي بالنسبة للعنصر الفردي، إلا أنه قد يؤدي مع ذلك إلى رد كلي إيجابي في حالة طلب عدة DIDs، بشرط دعم DID واحد على الأقل في الجلسة النشطة (AUTOSAR_AP_SWS_Diagnostics §7.3 «Multi-DID-Requests»).
سيناريوهات الأخطاء
عند استخدام الأخطاء وتمريرها عبر ara::diag::DiagUdsNrcErrorDomain، تُطبق حدود قيم وقواعد سلوك صارمة:
نطاق الصلاحية: تقع قيم UDS-NRC المسموح بها والمشتقة من DiagUdsNrcErrc حصريًا في النطاق من 0x01 إلى 0xFE[SWS_DM_02059].
الفشل عند الظروف البيئية: إذا فشل استرداد dataElement بسبب إبلاغ معالج خارجي عن خطأ في ara::diag::DiagUdsNrcErrorDomain، يقيّم DM التعبير DiagnosticEnvConditionFormulaPart بأنه غير مستوفٍ ويرسل رسالة Log-and-Trace [SWS_DM_00970].
معالجة الاستثناءات: تحول الدالة ThrowAsException() رمز ErrorCode إلى الاستثناء المقابل من النوع Exception (اسم بديل لـ DiagUdsNrcException) [SWS_DM_00531]، [SWS_DM_00535]. تم التصريح عن هذه العملية بأنها غير آمنة من الاستثناءات؛ وعند تعطيل C++-Exceptions، فإنها لا تشارك في حل التحميل الزائد [SWS_DM_00535].
حل الرسائل: توفر الدالة Message() سلسلة نصية وصفية لكل رمز خطأ يُمرر إليها، ويُضمن ألا تُرجع nullptr أبدًا [SWS_DM_00534].
يستند هذا الدليل إلى مواصفة AUTOSAR Adaptive R25-11 ويلخص متطلبات مجال الخطأ DiagUdsNrcErrorDomain.
Throw the exception type corresponding to the given ErrorCode. As per [SWS_CORE_10304], this function does not participate in overload resolution when C++ exceptions are disabled in the compiler toolchain.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 50f42aa82863المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تقوم دالة البناء الافتراضية الخالية من المعاملات بتهيئة نسخة من نطاق الخطأ ara::diag::DiagUdsNrcErrorDomain تزامparamتزامناً ودون معاملات ممررة [SWS_DM_00532]. ومن خلال توصيفها كـ constexpr، يمكن أن يتم إنشاء النسخة بالفعل أثناء وقت التجميع AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.1.1 «Default Constructor». ومع ذلك، في التنفيذ العملي، يُرجح أن يكون إنشاء نسخة مباشرة يدوياً من فئة النطاق [SWS_DM_00529] بواسطة كود التطبيق نادراً ما يكون مطلوباً، حيث يتم الحصول على المرجع العام افتراضياً عبر الدالة GetDiagUdsNrcDomain()[SWS_DM_00536]. سؤال Q-22c33afd620b536e (مفتوح)
فيما يتعلق بالتزامن والأمان من حيث الاستثناءات، تم تحديد دالة البناء كـ thread-safe وexception safe[SWS_DM_00532]. وهي معلنة كـ noexcept ولا تطلق أي استثناءات بذاتها. يدير النطاق رموز الخطأ لنوع التعداد DiagUdsNrcErrc عبر الاسم المستعار Errc[SWS_DM_00530]، والتي يتم إنشاؤها بواسطة MakeErrorCode()[SWS_DM_00537]. بالإضافة إلى ذلك، توفر الفئة دوالاً مثل Name()[SWS_DM_00533]، Message()[SWS_DM_00534] وكذلك ThrowAsException()[SWS_DM_00535] في إطار DiagUdsNrcException[SWS_DM_00531].
بالتكامل مع Diagnostic Management، تتحكم أخطاء هذا النطاق في معالجة الاستجابة السلبية. إذا أرجعت واجهة ara::diag خطأً من DiagUdsNrcErrorDomain، فإن Diagnostic Server يستنتج من ذلك استجابة UDS سلبية (NRC) بقيمة رمز الخطأ في النطاق الصالح من 0x01 إلى 0xFE [SWS_DM_02059]، [SWS_DM_02060]. وإذا حدث مثل هذا الخطأ أثناء استرداد عنصر سياق، يعتبر الخادم الشرط المعني غير مستوفٍ ويرسل رسالة Log-and-Trace [SWS_DM_00970].
تم إنشاء ملاحظة الاستخدام هذه آليًا بناءً على مواصفة AUTOSAR AP R25-11.
Translate an error code value into a text message.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 8d40cc1d5ceaالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تحوّل الدالة العضو المتزامنة Message للفئة ara::diag::DiagUdsNrcErrorDomain رمز خطأ رقمي إلى سلسلة نصية قابلة للقراءة [SWS_DM_00534]. يتم تمرير قيمة الخطأ errorCode من النوع ara::core::ErrorDomain::CodeType كمعامل. ويُرجع الاستدعاء مؤشرًا ثابتًا (const char *) إلى الرسالة المقابلة، مع ضمان ألا تكون القيمة المرجعة nullptr أبدًا [SWS_DM_00534].
معالجة الأخطاء والتزامن
تم التصريح عن الطريقة بـ noexcept وهي تضمن أمانًا تامًا من الاستثناءات (exception safe) [SWS_DM_00534]. ولا يتم إطلاق أي استثناءات. وحتى مع وجود قيم غير معروفة أو غير صالحة لـ errorCode، فمن المرجح أن يقدّم التنفيذ رسالة احتياطية ثابتة، نظرًا لأن المؤشر الفارغ مستبعد صراحةً [SWS_DM_00534]. سؤال Q-e9724baf4aedc3ff (مفتوح) بالإضافة إلى ذلك، تم تحديد الدالة بأنها آمنة لخيوط المعالجة (thread-safe) ويمكن استدعاؤها بالتوازي من عدة خيوط معالجة دون مزامنة خارجية [SWS_DM_00534].
التفاعل في Diagnostic Management
ضمن Diagnostic Management، تنفذ Message التجاوز القياسي لحل رسائل الخطأ خصيصًا لـ UDS Negative Response Codes (NRC) [SWS_DM_00534]. وهي تتوافق مع دوال مماثلة لنطاقات أخطاء تشخيص أخرى مثل DiagErrorDomain[SWS_DM_00522]، وDiagOfferErrorDomain[SWS_DM_00994]، وDiagReportingErrorDomain[SWS_DM_01001] وDiagSovdErrorDomain[SWS_DM_01814].
تم إنشاء هذا النص بواسطة نظام ذكاء اصطناعي بناءً على مواصفات AUTOSAR AP الإصدار R25-11.
Return the "shortname" ApApplicationErrorDomain.SN of this error domain.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 0056a3709625المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُرجع الدالة العضو Name للفئة ara::diag::DiagUdsNrcErrorDomain الاسم القصير (ApApplicationErrorDomain.SN) لنطاق أخطاء التشخيص المحدد هذا [SWS_DM_00533]. يتم الاستدعاء بشكل متزامن وتم التصريح عنه عبر ملف الترويسة ara/diag/diag_uds_nrc_error_domain.h. لا تأخذ الطريقة أي معاملات تمرير وتُرجع مؤشرًا من النوع const char * إلى سلسلة نصية منتهية بصفر [SWS_DM_00533].
معالجة الأخطاء
تم التصريح عن الدالة كـ noexcept وتمتلك الخاصية exception safe[SWS_DM_00533]. وهي لا ترمي استثناءات ولا تُرجع رموز أخطاء. ولم يُنص على فشل الاستعلام في تصميم الواجهة، ولهذا السبب لا توجد رسائل خطأ منفصلة.
التزامن والقيود
وفقًا للمواصفات، تم تصنيف Name على أنها thread-safe[SWS_DM_00533]. ويمكن استدعاؤها مع خاصية إعادة الدخول ودون آليات مزامنة خارجية بالتوازي من عدة خيوط معالجة. ومن المرجح أن تمثل السلسلة النصية المشار إليها بيانات مخصصة استاتيكيًا، بحيث يرجح أن يظل المؤشر صالحًا دون تغيير طوال فترة عمل التطبيق بأكملها. سؤال Q-d4a4d28af7a9c2df (مفتوح) ولا توجد شروط ترتيب خاصة للاستدعاء.
تفاعل
تنفذ العملية استعلام الأسماء الموحد لنطاقات أخطاء AUTOSAR Adaptive في سياق التشخيص. وهي تطابق هيكليًا واجهات بالاسم نفسه لنطاقات أخطاء ذات صلة مثل ara::diag::DiagErrorDomain::Name[SWS_DM_00521]، وara::diag::DiagOfferErrorDomain::Name[SWS_DM_00993]، وara::diag::DiagReportingErrorDomain::Name[SWS_DM_01000]، بالإضافة إلى ara::diag::DiagSovdErrorDomain::Name[SWS_DM_01813]. وتُستخدم بشكل أساسي لتحديد الأخطاء من بيئة UDS NRC بشكل قابل للقراءة لعملاء التشخيص أو مكونات التسجيل (Logging).
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا استنادًا إلى مواصفات AUTOSAR.
Throw the exception type corresponding to the given ErrorCode. As per [SWS_CORE_10304], this function does not participate in overload resolution when C++ exceptions are disabled in the compiler toolchain.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: e2f3a36037beالمصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم الدالة العضو ara::diag::DiagUdsNrcErrorDomain::ThrowAsException لتحويل خطأ من نطاق أخطاء UDS NRC بشكل متزامن إلى استثناء C++ [SWS_DM_00535]. ويتم تمرير النسخة errorCode من النوع const ara::core::ErrorCode& كمعامل. ليس للدالة قيمة مرجعة، بل تطلق مباشرة نوع الاستثناء المقترن برمز الخطأ AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 «ThrowAsException».
فيما يتعلق بسلوك الأخطاء ووقت التشغيل، تم التصريح عن الدالة باستخدام noexcept(false) وتصنيفها على أنها غير آمنة من حيث الاستثناءات (not exception safe)، نظرًا لأن إطلاق الاستثناء يمثل دلالتها الأساسية [SWS_DM_00535]. وبالنسبة لسياق الاستدعاء المتزامن، تم تحديد الدالة على أنها آمنة خيطيًا (thread-safe) [SWS_DM_00535].
تنطبق الشروط ومراجع التصميم التالية عند الدمج وتهيئة النظام:
قيد المترجم: إذا تم تعطيل استثناءات C++ في سلسلة أدوات المترجم، فإن هذه الدالة لا تشارك في حل التحميل الزائد (overload resolution) وفقًا لـ [SWS_CORE_10304][SWS_DM_00535].
التفاعل مع نطاقات الأخطاء: يتم تطبيق نفس المخطط لإطلاق الاستثناءات بشكل موحد في نطاقات تشخيصية أخرى، كما هو الحال في DiagErrorDomain[SWS_DM_00523]، وDiagOfferErrorDomain[SWS_DM_00995]، وDiagReportingErrorDomain[SWS_DM_01002]، وDiagSovdErrorDomain[SWS_DM_01815].
تم إنشاء ملاحظة الاستخدام هذه آليًا استنادًا إلى مواصفة AUTOSAR Adaptive R25-11.
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني