تُستخدم كواجهة للتطبيقات لفحص وتنفيذ عمليات إعادة ضبط وحدات التحكم الإلكترونية عبر UDS في Diagnostic Management.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 5b921e2dd86fالمصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم كواجهة للتطبيقات لفحص وتنفيذ عمليات إعادة ضبط وحدات التحكم الإلكترونية عبر UDS في Diagnostic Management.
تمثّل الفئة ara::diag::EcuResetRequest واجهة التطبيق لمعالجة خدمات إعادة الضبط لـ UDS (الخدمة 0x11) في Diagnostic Management AUTOSAR_AP_SWS_Diagnostics §7.3.2.8.5.1. وبعد التنشيط بواسطة Offer()، تستقبل الطلبات لفحص وتنفيذ عمليات إعادة التشغيل، بالإضافة إلى التحكم في الإيقاف السريع (Rapid Shutdown) ([SWS_DM_01016]، [SWS_DM_01013]، [SWS_DM_01014]). والنسخ غير قابلة للنسخ أو النقل، وقد تم تحديد كافة الطرق على أنها ليست آمنة خيطياً ([SWS_DM_01010]، [SWS_DM_01621]).
السياق
تُستخدم فئة الواجهة ara::diag::EcuResetRequest لمعالجة خدمة UDS المسماة ECUReset (الخدمة 0x11) في AUTOSAR Adaptive Platform AUTOSAR_AP_SWS_Diagnostics §7.3.2.8.5.1 «Service 0x11 – ECUReset – RapidPowerShutdown sub function». وتتيح للتطبيق العمل كمعالج (handler) لطلبات إعادة الضبط الواردة من Diagnostic Management (DM). وتشمل المهام تنشيط أو إلغاء تنشيط الإيقاف السريع ([SWS_DM_01012])، وفحص طلبات إعادة الضبط الواردة ([SWS_DM_01013])، بالإضافة إلى التنفيذ الفعلي لإعادة التشغيل ([SWS_DM_01014]). وتتضمن أطراف التفاعل المشاركة كلاً من جهاز الفحص التشخيصي الخارجي، ونسخة Diagnostic Management (DM أو خادم التشخيص Diagnostic Server)، والتنفيذ من جانب التطبيق لـ EcuResetRequest.
يتم إنشاء نسخة من EcuResetRequest عبر مُنشئها الصريح مع تحديد ara::core::InstanceSpecifier يشير إلى PortPrototype خاص بـ DiagnosticEcuResetInterface ([SWS_DM_01010]). ووفقاً لمتطلبات التصميم، فإن الفئة غير قابلة للنسخ أو النقل؛ حيث تم حذف مُنشئات النسخ والنقل ([SWS_DM_01621]، [SWS_DM_01622]) وعوامل الإسناد المقابلة لها ([SWS_DM_01619]، [SWS_DM_01620]) صراحةً (=delete). وقد تم تحديد كافة طرق الواجهة وكذلك المُدمّر ([SWS_DM_01011]) بوصفها not thread-safe ([SWS_DM_01010]، [SWS_DM_01016]، [SWS_DM_01017]). وبعد التهيئة، يكون المعالج في البداية في الحالة التي لا يحدث فيها إعادة توجيه للطلبات، إلى أن يتم تفعيل التسجيل صراحةً عبر Offer() ([SWS_DM_01016]). وعبر استدعاء StopOffer()، يتم إلغاء تنشيط إعادة توجيه الطلبات مجدداً ([SWS_DM_01017]) قبل أن يتسنى تدمير الكائن ([SWS_DM_01011]).
ينقسم مسار الاستخدام النموذجي إلى التهيئة، والإتاحة، والمعالجة اللاحقة لطلبات التشخيص:
إنشاء النسخة والإتاحة: ينشئ التطبيق نسخة من الفئة المشتقة مع InstanceSpecifier المناسب ([SWS_DM_01010]) ويستدعي Offer() لتمكين DM من إعادة توجيه الطلبات ([SWS_DM_01016]).
طلب إعادة الضبط: لكافة وظائف UDS الفرعية الأخرى لإعادة الضبط، يستدعي DM الطريقة RequestReset(resetType, id, metaInfo, cancellationHandler) ([SWS_DM_01013]). ويجب على العملية المُنشِئة للنسخة أن تفحص بعناية ما إذا كان يُسمح بإعادة تشغيل أجزاء من الآلة أو الآلة بأكملها ([SWS_DM_01013]). وعبر cancellationHandler يمكن الاستعلام عن حالة الإلغاء أو تسجيل مُخطِر Notifier ([SWS_DM_01013]).
تنفيذ إعادة الضبط: إذا تم قبول الطلب وكان قد تم تكوين إرسال الاستجابة الإيجابية قبل إعادة الضبط (respondBeforeReset أو غير موجود)، يُرسل خادم التشخيص استجابة UDS الإيجابية ويستدعي بعد ذلك ExecuteReset(metaInfo) (AUTOSAR_AP_SWS_Diagnostics §7.3.2.8.5.2 [SWS_DM_01023]، [SWS_DM_01014]). أما إذا تم تكوين respondAfterReset بدلاً من ذلك، فلن تُعاد الاستجابة الإيجابية إلا بعد إعادة التشغيل، شريطة ألا يكون RequestReset() قد أبلغ عن أي خطأ (AUTOSAR_AP_SWS_Diagnostics §7.3.2.8.5.2 [SWS_DM_00360]).
إلغاء تسجيل الخدمة: لإنهاء إعادة توجيه الخدمة، يستدعي التطبيق StopOffer() ([SWS_DM_01017]).
في حالة الخطأ، يجب مراعاة الجوانب التالية عند مختلف الاستدعاءات:
انتهاكات المُنشئ: عند الإنشاء، يمكن أن تحدث انتهاكات للنموذج، من بينها عدم إمكانية تحليل InstanceSpecifier في النموذج (InstanceSpecifierMappingIntegrityViolation)، أو إشارته إلى عنصر نموذج خاطئ، أو غياب تعيين المنفذ (PortInterfaceMappingViolation)، أو عدم وجود ارتباط بالعملية (ProcessMappingViolation)، أو كون المعرف مستخدماً بالفعل داخل العملية (InstanceSpecifierAlreadyInUseViolation) ([SWS_DM_01010]).
أخطاء التسجيل: إذا تم استدعاء Offer() على الرغم من كون الخدمة معروضة بالفعل، تُرجع الطريقة ara::core::Result مع رمز الخطأ DiagOfferErrc::kAlreadyOffered ([SWS_DM_01016]).
رموز الأخطاء التشخيصية (NRCs): إذا تعذر إتمام EnableRapidShutdown أو RequestReset أو ExecuteReset بنجاح، تُرجع كائنات Future الناتجة عنها خطأ مع رمز استجابة سلبية مناسب وفقاً للمعيار ISO 14229-1 Negative Response Code (NRC) عبر DiagUdsNrcErrc ([SWS_DM_01012]، [SWS_DM_01013]، [SWS_DM_01014]). وتجدر الإشارة إلى أنه: إذا تم ضبط respondToReset على respondBeforeReset أو لم يتم تكوينه، فلن يكون لأي خطأ في ExecuteReset() أي تأثير على استجابة التشخيص، نظراً لأنه قد تم إرسال التأكيد الإيجابي بالفعل مسبقاً إلى جهاز الفحص ([SWS_DM_01014]، AUTOSAR_AP_SWS_Diagnostics §7.3.2.8.5.2 [SWS_DM_01023]).
يستند هذا الدليل حصريًا إلى مواصفات AUTOSAR Adaptive Platform R25-11.
Called for any EcuReset subFunction, except En-/DisableRapidShutdown. The process, which is instantiating this interface, needs to evaluate carefully if the request to restart parts or the whole machine. Once the request to reset is accepted, the process, which is instantiating this interface, has to rely on this decision for the ExecuteReset() trigger.
InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of your executable, or it refers to a model element other tegrityViolation than a PortPrototype. PortInterfaceMap- A PortPrototype that is typed by a pingViolation DiagnosticEcuResetInterface needs to be referenced by a DiagnosticServiceGenericMapping. ProcessMappingVio- Matching InstanceRef exists, but no matching (modelled) Process lation found that matches the (runtime) process. InstanceSpecifier- Violation message that is sent in case a constructor in the ara AlreadyInUseViola- framework was called with an InstanceSpecifier already in use in tion this process.
Parameter (in)
Parameter
Beschreibung
specifier
InstanceSpecifier to a PortPrototype of a DiagnosticEcuResetInterface.
Request a governed re-review of this record. The record is not changed immediately.
Interface for subFunction En-/DisableRapidShutdown.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 64d1feb19eceالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام وسياق الاستدعاء
تعمل الطريقة الافتراضية الصرفة EnableRapidShutdown من الفئة ara::diag::EcuResetRequest كواجهة لمعالجة وظائف UDS الفرعية الخاصة بإيقاف التشغيل السريع ([SWS_DM_01012]). عند ورود طلبات تشخيص للخدمة 0x11 (ECUReset)، يستدعي Diagnostic Manager (DM) هذه الدالة: للوظيفة EnableRapidPowerShutdown باستخدام الوسيطة enable = true ([SWS_DM_01020]) وللوظيفة DisableRapidPowerShutdown باستخدام enable = false ([SWS_DM_01021]). وهذا يميز هاتين الوظيفتين الفرعيتين عن جميع خدمات ECUReset الأخرى، والتي تطلق بدلاً من ذلك RequestReset ([SWS_DM_00235]).
enable: ينشط إيقاف التشغيل السريع عند true ويلغي تنشيطه عند false.
metaInfo: يمرر معلومات وصفية لطلب التشخيص.
cancellationHandler: يُستخدم لمراقبة حالة الإلغاء عبر cancellationHandler.IsCanceled() أو لتسجيل مُخطر عبر cancellationHandler.SetNotifier() في حال تم إلغاء محادثة التشخيص الجارية.
الدلالات، ومعالجة الأخطاء، والتزامن
ترجع الواجهة ara::core::Future<void>؛ وبالتالي يُفترض أن المعالجة الفعلية تتم بشكل غير متزامن في الخلفية ([SWS_DM_01012]). سؤال Q-ee781913ae88fabb (مفتوح) في حالة النجاح، لا يعيد الـ Future أي قيمة. وفي حالة الخطأ، يجب تعيين رمز استجابة سلبية (NRC) مناسب وفقاً للمعيار ISO 14229-1 بواسطة DiagUdsNrcErrc (AUTOSAR_AP_SWS_Diagnostics §8.16.3.1.3.1 «EnableRapidShutdown»). تم تحديد الدالة على أنها noexcept وآمنة من الاستثناءات (exception safe)، ولكنها تُعتبر غير آمنة لمؤشرات الترابط (not thread-safe)، ولهذا السبب يجب تجنب الاستدعاءات المتزامنة على نفس المثيل من جانب التطبيق ([SWS_DM_01012]).
تم توليد هذا النص بواسطة ذكاء اصطناعي استنادًا إلى مواصفة AUTOSAR R25-11.
When enable is set to true the rapid shutdown will be enabled, setting enable to false will disable rapid shutdown.
metaInfo
MetaInfo of the request.
cancellationHandler
This parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.
process which is instantiating this interface, has to execute the requested reset.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 5a6dac3995bcالمصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
يتم استدعاء الطريقة ExecuteReset من الواجهة ara::diag::EcuResetRequest بواسطة خادم التشخيص (DM) لإطلاق إعادة ضبط ECU المقبولة مسبقاً عبر [SWS_DM_01013] فعلياً في العملية المنفذة [SWS_DM_01014]. يتم تمرير metaInfo لطلب التشخيص كمعلمة. تم تحديد الدالة بأنها غير آمنة لمؤشرات الترابط (not thread-safe)، ولكنها آمنة من الاستثناءات (exception safe) [SWS_DM_01014].
يعتمد وقت الاستدعاء بواسطة خادم التشخيص على معلمة التكوين DiagnosticEcuResetClass.respondToReset:
إذا كانت المعلمة غير موجودة أو معينة على respondBeforeReset، فلن يستدعي خادم التشخيص ExecuteReset إلا بعد إرسال استجابة UDS الإيجابية [SWS_DM_01023].
إذا تم تكوين respondAfterReset، فسيتم استدعاء ExecuteReset مباشرةً ودون إرسال مسبق للاستجابة الإيجابية [SWS_DM_01090].
ترجع الدالة ara::core::Future<void>[SWS_DM_01014]. وإذا تم حظر طلبات UDS الواردة بعد قبول إعادة الضبط [SWS_DM_01022]، فإن خادم التشخيص يرفع هذا الحظر بمجرد اكتمال Future المرجع من ExecuteReset[SWS_DM_01309]. يتم الإشارة إلى الأخطاء المحتملة عبر رموز NRC الخاصة بالمعيار ISO-14229-1 بواسطة DiagUdsNrcErrc في Future؛ ومع ذلك، في التكوين respondBeforeReset، يظل الخطأ الممرر عديم التأثير [SWS_DM_01014].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويستند إلى AUTOSAR Release R25-11.
Return nothing or an error. In case the parameter DiagnosticEcu ResetClass.respondToReset is either not present or present and set to respondBeforeReset, a given error has no effect.
Fehler
Fehlercode
Beschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.
Request a governed re-review of this record. The record is not changed immediately.
This Offer will enable the DM to forward request messages to this handler.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: c497a60736afالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
باستخدام الطريقة ara::diag::EcuResetRequest::Offer ([SWS_DM_01016])، يشير تطبيق تكيّفي (Adaptive Application) إلى Diagnostic Management (DM) بأنه جاهز لاستقبال طلبات التشخيص الواردة لإعادة ضبط ECU. ومن خلال الاستدعاء المتزامن، يتم تفويض DM لإعادة توجيه رسائل الطلب المقابلة إلى هذا المعالج ([SWS_DM_01016]). يُرجح أن يتم الاستدعاء عادةً أثناء مرحلة تهيئة التطبيق، قبل أن يتولى DM معالجة طلبات التشخيص. سؤال Q-93d794e6b1dba23e (مفتوح)
الاستدعاء ومعالجة الأخطاء
لا تحتوي الدالة على معلمات تمرير، وهي مصرح عنها كـ noexcept وتضمن أمان الاستثناءات ([SWS_DM_01016]). وتُستخدم قيمة إرجاع هي ara::core::Result<void>. وإذا فشل التوفير لأن الخدمة قد عُرضت بالفعل مسبقاً، فإن الطريقة تعيد رمز الخطأ DiagOfferErrc::kAlreadyOffered مع دلالات التراجع ([SWS_DM_01016]).
التزامن والتفاعل
وفقاً للمواصفات، تم تصنيف الدالة على أنها not thread-safe ([SWS_DM_01016]). لذلك يجب مزامنة الاستدعاءات على نفس المثيل من ara::diag::EcuResetRequest من جانب التطبيق. يتوافق نمط التوفير مع تصميم الواجهة الموحد في Adaptive Diagnostic Management، كما تم تحديده بالمثل لمعالجات أخرى مثل ara::diag::GenericUDSService::Offer ([SWS_DM_00619]) أو ara::diag::GenericRoutine::Offer ([SWS_DM_00557]) أو ara::diag::CommunicationControl::Offer ([SWS_DM_00809]). على الرغم من أن التسمية مستوحاة من ara::com، إلا أنها تطبيق مستقل لـ Diagnostic Management (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors»).
تم إنشاء ملاحظة الاستخدام هذه تلقائياً وتستند إلى مواصفات AUTOSAR Adaptive R25-11.
Called for any EcuReset subFunction, except En-/DisableRapidShutdown. The process, which is instantiating this interface, needs to evaluate carefully if the request to restart parts or the whole machine. Once the request to reset is accepted, the process, which is instantiating this interface, has to rely on this decision for the ExecuteReset() trigger.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 4ec2f9bf44c2المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
يتم استدعاء الدالة ara::diag::EcuResetRequest::RequestReset (#include "ara/diag/ecu_reset_request.h") بواسطة خادم التشخيص بمجرد استلام طلب UDS للخدمة 0x11 (ECUReset) ([SWS_DM_00235]، SWS Diagnostics §7.3.2.8.5.2 «Service 0x11 – ECUReset – all other sub functions»). ويسري ذلك على جميع الدوال الفرعية لإعادة التعيين باستثناء EnableRapidPowerShutdown وDisableRapidPowerShutdown ([SWS_DM_01013]). ويجب على التطبيق المُنشئ للمثيل التحقق بعناية قبل القبول مما إذا كان يُسمح بإجراء إعادة تشغيل لأجزاء من الآلة أو للآلة بأكملها ([SWS_DM_01013]).
المعاملات والواجهة غير المتزامنة
يمرر الاستدعاء نوع إعادة التعيين resetType، ومُعرّفًا اختياريًا id (يتم تقييمه فقط عندما يكون resetType مضبوطًا على custom)، والبيانات الوصفية metaInfo بالإضافة إلى cancellationHandler ([SWS_DM_01013]). عبر cancellationHandler، يمكن للتطبيق تحديد حالة الإلغاء باستخدام IsCanceled أو تسجيل دالة استدعاء راجع (Callback) لأحداث الإلغاء بواسطة SetNotifier ([SWS_DM_01013]). وتُتاح النتيجة بشكل غير متزامن عبر ara::core::Future<void> ([SWS_DM_01013]).
معالجة الأخطاء، والتحكم في التدفق، والتزامن
إذا تعذر قبول إعادة التعيين، فيجب إرجاع رمز خطأ NRC مناسب في Future عبر DiagUdsNrcErrc وفقًا للمواصفة ISO 14229-1 ([SWS_DM_01013])؛ بالإضافة إلى ذلك، يؤخذ الإبلاغ عن ApApplicationError في الاعتبار ([SWS_DM_00360]). وإذا تم قبول الطلب، يكون هذا القرار ملزمًا لمُشغل ExecuteReset اللاحق ([SWS_DM_01013])، ويتجاهل خادم التشخيص طلبات UDS اللاحقة الواردة ([SWS_DM_01022]) حتى يتم رفع الحظر بعد اكتمال ExecuteReset ([SWS_DM_01309]). ويعتمد التنفيذ الفعلي لإعادة التعيين على DiagnosticEcuResetClass.respondToReset؛ فإما أن يتم بعد إرسال استجابة UDS الإيجابية ([SWS_DM_01023]) أو مباشرة قبل إعادة التشغيل ([SWS_DM_01090]). تم تحديد الدالة بأنها exception safe، ولكن صراحة بأنها not thread-safe ([SWS_DM_01013]).
تستند ملاحظة الاستخدام هذه إلى مواصفة AUTOSAR Adaptive Platform الإصدار R25-11.
id of the custom reset type. Will only be evaluated when resetType is "custom".
metaInfo
MetaInfo of the request.
cancellationHandler
This parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.
This StopOffer will disable the forwarding of request messages from DM.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: b9e940cd3ae2المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تنهي الطريقة ara::diag::EcuResetRequest::StopOffer تقديم خدمة إعادة التعيين وتلغي تفعيل إعادة توجيه رسائل الطلب الواردة من Diagnostic Management (DM) إلى التطبيق ([SWS_DM_01017]، AUTOSAR_AP_SWS_Diagnostics §8.16.3.1.3.5 «StopOffer»). وللدالة التوقيع void StopOffer() noexcept، ولا تتوقع أي معلمات ولا تعيد أي قيمة إرجاع.
معالجة الأخطاء وسلوك الاستثناءات
تم التصريح عن العملية كـ noexcept وتصنيفها من حيث المواصفات على أنها آمنة من الاستثناءات (exception safe) ([SWS_DM_01017]). ولا يتم رمي استثناءات ولا إرجاع رموز أخطاء محددة إلى المستدعي.
التزامن والقيود
تم تصنيف الطريقة صراحةً على أنها غير آمنة خيطياً (not thread-safe) ([SWS_DM_01017]). ويجب على المستدعين مزامنة الوصول المتزامن إلى نفس النسخة من ara::diag::EcuResetRequest من جانب التطبيق. ومن الناحية الوظيفية، يُرجح ألا يكون الاستدعاء مخصصاً إلا بعد تقديم مسبق للمعالج، وذلك لإيقاف استقبال المزيد من طلبات إعادة التعيين بطريقة منظمة. سؤال Q-25f37b77dc8cf80f (مفتوح)
تفاعل
يتبع إلغاء تفعيل إعادة التوجيه عبر StopOffer نمط الواجهة الموحد لمعالجات التشخيص الوظيفية في Adaptive AUTOSAR، كما هو محدد بشكل مماثل أيضاً لخدمات أخرى مثل CommunicationControl ([SWS_DM_00810]) أو DownloadService ([SWS_DM_00793]).
تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR Adaptive R25-11.
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني