يوفّر نمط طاقة DoIP الحالي للمركبة إلى Diagnostic Management عبر واجهة رد نداء.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: afa4b2f1975cالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
يوفّر نمط طاقة DoIP الحالي للمركبة إلى Diagnostic Management عبر واجهة رد نداء.
تتيح فئة الواجهة ara::diag::DoIPPowerMode للتطبيقات توفير نمط طاقة DoIP الحالي إلى Diagnostic Management عبر دالة رد النداء GetDoIPPowerMode()[SWS_DM_00734]. بعد إنشاء المثيل، يجب تنشيط المعالج عبر Offer() وإلغاء تسجيله مرة أخرى قبل الهدم عبر StopOffer()[SWS_DM_00735]، [SWS_DM_00736]. وباعتبارها نموذجًا فرديًا، فإن الفئة غير قابلة للنسخ أو النقل [SWS_DM_01645].
السياق
تحدد الفئة المجردة ara::diag::DoIPPowerMode الواجهة لتوفير نمط طاقة DoIP الحالي إلى Diagnostic Management (DM). وفي معماريات المركبات التي تستخدم التشخيص عبر بروتوكول الإنترنت (DoIP)، يجب أن يكون بروتوكول الاتصال على دراية بحالة تشغيل شبكة المركبة أو إمداد الجهد. يشتق برنامج التطبيق فئة معالج ملموسة من ara::diag::DoIPPowerMode وينفّذ استعلام نمط الطاقة [SWS_DM_00734]. وتتمثل أطراف التفاعل في تطبيق التشخيص الموفِّر الذي يعرض الواجهة، بالإضافة إلى نظام وقت التشغيل الخاص بـ DM الذي يفوّض الطلبات الواردة إلى هذا المعالج [SWS_DM_00735].
دورة الحياة
يتم إنشاء مثيلات ara::diag::DoIPPowerMode داخليًا في التطبيق ويتم تحديدها عبر نموذج منفذ أولي يُشار إليه بواسطة ara::core::InstanceSpecifier[SWS_DM_00732]. وعند استدعاء المنشئ، يتم تحديد ما إذا كان يجب تنفيذ دالة رد النداء GetDoIPPowerMode() بأمان من حيث الخيوط (kConcurrent) أو بدون أمان من حيث الخيوط (kNotConcurrent) عبر الوسيطة ConcurrencyType[SWS_DM_00732]. والمنشئ نفسه مُنفَّذ بأمان من حيث الخيوط [SWS_DM_00732].
بعد إنشاء المثيل، يجب تنشيط المعالج عبر Offer() لكي يتمكن DM من توجيه الطلبات [SWS_DM_00735]. ولإنهاء توجيه الطلبات، يتم استدعاء StopOffer()[SWS_DM_00736]. وقد تم تحديد الهادم الافتراضي ~DoIPPowerMode()[SWS_DM_00733] بالإضافة إلى Offer() وStopOffer() على أنها غير آمنة من حيث الخيوط. ويُفترض أنه ينبغي دائمًا تنفيذ StopOffer() قبل استدعاء الهادم لفصل التفاعلات المعلقة مع DM بشكل صحيح. سؤال Q-85ede935aa303c45 (مفتوح)
مسار الاستخدام
يتّبع الاستخدام النموذجي لـ ara::diag::DoIPPowerMode تسلسلاً ثابتًا يتكون من التهيئة، وتسجيل الخدمة، والاستعلام الدوري أو المستند إلى الأحداث عن النمط، وإلغاء التسجيل:
ينشئ التطبيق مثيلاً من فئته المشتقة باستخدام InstanceSpecifier المناسب وConcurrencyType المطلوب [SWS_DM_00732].
يسجّل التطبيق المعالج بنشاط لدى Diagnostic Management بواسطة Offer()[SWS_DM_00735].
بمجرد أن يحتاج بروتوكول DoIP إلى الحالة، يستدعي DM الدالة الافتراضية الصرفة GetDoIPPowerMode()[SWS_DM_00734]. ويعيد التنفيذ ara::core::Future<PowerModeType>، والذي يتم حله بشكل غير متزامن [SWS_DM_00734].
عند إنهاء التشغيل، يستدعي التطبيق StopOffer() حتى لا يستقبل أي طلبات أخرى [SWS_DM_00736].
عند استدعاء المنشئ، يمكن أن تحدث انتهاكات في النموذج والتعيين تكون موثقة [SWS_DM_00732]:
InstanceSpecifierMappingIntegrityViolation: لا يمكن حل المعرّف في سياق الملف القابل للتنفيذ أو أنه لا يشير إلى عنصر PortPrototype [SWS_DM_00732].
PortInterfaceMappingViolation: إن PortPrototype المشار إليه ليس من النوع DiagnosticDoIPPowerModeInterface[SWS_DM_00732].
ProcessMappingViolation: يوجد مرجع للمثيل، ولكن لا توجد عملية منمذجة مطابقة لبيئة وقت التشغيل [SWS_DM_00732].
InstanceSpecifierAlreadyInUseViolation: تم استخدام InstanceSpecifier بالفعل لمثيل آخر داخل نفس العملية [SWS_DM_00732].
إذا تم استدعاء Offer() بينما الخدمة معروضة بنشاط بالفعل، فإن الدالة تعيد رمز الخطأ DiagOfferErrc::kAlreadyOffered عبر ara::core::Result[SWS_DM_00735]. وفي المقابل، لا تحدد الدالة GetDoIPPowerMode() أي رموز خطأ قياسية [SWS_DM_00734].
يعتمد هذا الدليل على مواصفة AUTOSAR الخاصة بـ Adaptive Platform (الإصدار R25-11). وتستند جميع البيانات ورموز الأخطاء إلى متطلبات SWS المشار إليها.
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 referenced by a pingViolation DiagnosticDoIpPowerModePortMapping needs to be typed by a DiagnosticDoIPPowerModeInterface. 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 DiagnosticDoIPPowerModeInterface
concurrencyType
Specifies if the interface is implemented as thread safe ( kConcurrent) or non-thread safe (kNotConcurrent)..
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 · درجة الحرارة: غير قابل للتحكم · الموجّه: 5f8fb75036b6المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم الطريقة المتزامنة Offer للفئة ara::diag::DoIPPowerMode بواسطة Adaptive Application لتسجيل خدمة DoIP Power Mode لدى Diagnostic Management (DM) وتمكينها [SWS_DM_00735]. ويمكّن هذا الاستدعاء الـ DM من إعادة توجيه رسائل الطلبات الواردة إلى هذا المعالج [SWS_DM_00735]. لا تتوقع الدالة أي معاملات ممررة، ولا تطلق أي استثناءات (noexcept)، وتُرجع ara::core::Result<void> كقيمة إرجاع [SWS_DM_00735].
طالما لم يتم استدعاء Offer بواسطة التطبيق الموفر بعد، يجيب DM على طلبات العميل للحصول على معلومات DoIP Power Mode بالقيمة الإرشادية 0 («Not ready») وفقًا للمواصفة ISO 13400-2 [SWS_DM_01525]. وإذا كان المعالج مسجلاً ويحتاج DM إلى وضع الطاقة الحالي للرد على رسائل DoIP، فإنه يستعلم عنه عبر ara::diag::DoIPPowerMode::GetDoIPPowerMode[SWS_DM_00814].
في حالة حدوث خطأ، يحتوي الكائن Result على رمز خطأ مطابق. وإذا تم استدعاء الطريقة بنجاح على المثيل المعني سابقًا، فإن أي استدعاء متجدد سيفشل ويُرجع DiagOfferErrc::kAlreadyOffered بدلالات التراجع [SWS_DM_00735].
فيما يتعلق بالتزامن، تم تحديد الدالة على أنها غير آمنة خيطيًا (not thread-safe) [SWS_DM_00735]. لذلك، يجب مزامنة الاستدعاءات المتوازية على نفس المثيل بواسطة المستدعي. وتوفر الدالة أمانًا كاملاً من حيث الاستثناءات (exception safe) [SWS_DM_00735].
تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي وتستند إلى مواصفات إصدار AUTOSAR R25-11.
This StopOffer will disable the forwarding of request messages from DM.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 2a0861404a22المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تعطل الدالة StopOffer التابعة للفئة ara::diag::DoIPPowerMode قيام Diagnostic Management (DM) بإعادة توجيه رسائل طلب التشخيص الواردة إلى المعالج [SWS_DM_00736]. تتوفر الدالة عبر ملف الترويسة ara/diag/doip_power_mode.h، وليس لها قيمة إرجاع ولا تقبل أي معلمات [SWS_DM_00736].
تنطبق تفاصيل المواصفات التالية على سلوك الأخطاء وبيئة التنفيذ:
أمان الاستثناءات: تم التصريح عن الدالة كـ noexcept، وتحديدها بأنها آمنة من الاستثناءات (exception safe) [SWS_DM_00736]. ولا يتم إطلاق أي استثناءات، كما لا تُرجع أي رموز خطأ.
أمان الخيوط: تم تحديد العملية بأنها غير آمنة بالنسبة للخيوط (not thread-safe) [SWS_DM_00736]. التفسير: إذا تم استدعاء الدالة في سيناريوهات متعددة الخيوط أو بالتوازي مع عمليات أخرى لنفس النسخة، فيُرجح أن تكون هناك حاجة إلى مزامنة خارجية من قِبل التطبيق. سؤال Q-1593f08472d584d1 (مفتوح)
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني