Diese Seite wurde vollständig KI-generiert auf Basis von SWS Safe Hardware Acceleration (R25-11) — kein offizieller AUTOSAR-Text und keine automatisch extrahierte API-Seite wie die übrigen Module. Als Interpretation gekennzeichnete Aussagen sind Schlussfolgerungen aus den Quellen.
[AP_SWS_SHWA_01401] لم يُستورد النص بعدUpstream: RS_SHWA_00004
class DeviceMonitor final {...};
Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.
تتيح مراقبة أجهزة العتاد والاستعلام عن حالة تشغيلها الحالية.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 7b51b19e11acالمصدرأسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تتيح مراقبة أجهزة العتاد والاستعلام عن حالة تشغيلها الحالية.
تُستخدم الفئة ara::shwa::DeviceMonitor للمراقبة المتزامنة لحالة أجهزة العتاد في العنقود الوظيفي shwa. يتم إنشاء المثيلات عبر دالة المصنع الثابتة Create بالاستناد إلى مرجع جهاز ([AP_SWS_SHWA_01407])، وبعد ذلك يمكن الاستعلام عن حالة الجهاز باستمرار عبر الطريقة Status() ([AP_SWS_SHWA_01409]). بينما يتم تنفيذ الإنشاء عبر دوال المصنع بطريقة آمنة مع الخيوط، فإن استدعاء الاستعلام عن الحالة ليس آمنًا مع الخيوط ويتطلب على الأرجح مزامنة من جانب التطبيق في حالة الوصول المتوازي. سؤال (مفتوح)
السياق
توفر الفئة ara::shwa::DeviceMonitor في الوحدة shwa الواجهة المركزية لمراقبة حالة أجهزة العتاد. تستخدم برمجيات التطبيق هذه الفئة للاستعلام عن حالة تشغيل أحد مكونات العتاد المعرّف عبر مرجع جهاز Device أو عبر عنصر محدد DeviceSelector ([AP_SWS_SHWA_01407]، [AP_SWS_SHWA_01408]). ومن خلال تغليف عملية تحديد الحالة في نوع الإرجاع DeviceStatus ([AP_SWS_SHWA_01409])، تفصل DeviceMonitor تطبيق التحكم المُستدعي عن تفاصيل العتاد الداخلية وتعمل كمراقب قياسي لدورة حياة الجهاز المُعنون ودورة أخطائه.
دورة الحياة
لا يمكن إنشاء مثيلات DeviceMonitor عبر مُنشئ افتراضي بدون معاملات، نظرًا لحذفه صراحة ([AP_SWS_SHWA_01402]). وبدلًا من ذلك، يتم إنشاء الكائن بصورة مضبوطة عبر طريقتي مصنع ثابتتين: Create(const Device &device) ([AP_SWS_SHWA_01407]) أو دالة القالب Create(const DeviceSelector &deviceSelector) ([AP_SWS_SHWA_01408]). يعيد كلا مساري المصنع ara::core::Result<DeviceMonitor>، وقد تم تحديدهما كآمنين ضد الاستثناءات (exception safe) ويضمنان الأمان مع الخيوط.
في موضوع التزامن، يجب التمييز بدقة بين الإنشاء والاستخدام: فبينما يُعد الإنشاء عبر دوال المصنع آمنًا مع الخيوط، تم التصريح صراحة عن طريقة الاستعلام Status() بأنها غير آمنة مع الخيوط (not thread-safe) ([AP_SWS_SHWA_01409]). في حالة الوصول المتوازي لعدة خيوط إلى نفس المثيل، فمن المحتمل أن تكون هناك حاجة لمزامنة من جانب التطبيق. سؤال Q-4002d6fb6cac23ce (مفتوح)
مسار الاستخدام
ينقسم مسار الاستخدام النموذجي إلى إنشاء مثيل المراقب، والتحقق من صحة النتيجة، والاستعلام المتكرر عن حالة الجهاز. أولًا، يستدعي التطبيق إحدى طرق المصنع Create ويمرر المكون الهدف ([AP_SWS_SHWA_01407]، [AP_SWS_SHWA_01408]). بعد ذلك، يتحقق التطبيق من نجاح ara::core::Result الناتج. إذا كان الكائن صالحًا، يتم استدعاء الطريقة Status() ([AP_SWS_SHWA_01409])، والتي توفر بشكل متزامن كائنًا من النوع DeviceStatus.
تحدث الأخطاء بصورة رئيسية أثناء الإنشاء عبر طرق المصنع Create ويتم توفيرها دون استثناءات C++ في نوع الإرجاع ara::core::Result عبر ShwaErrorCode ([AP_SWS_SHWA_01407]، [AP_SWS_SHWA_01408]). تم تعريف حالات الخطأ التالية لعملية الإنشاء:
ShwaErrorCode::kInvalidParameter: تم تمرير وسيطة غير صالحة للاستدعاء، على سبيل المثال تحديد غير مسموح به للجهاز ([AP_SWS_SHWA_01407]، [AP_SWS_SHWA_01408]).
ShwaErrorCode::kFeatureNotSupported: وظيفة المراقبة المطلوبة غير مدعومة من قِبل المنصة الهدف أو تكوين العتاد ([AP_SWS_SHWA_01407]، [AP_SWS_SHWA_01408]).
أثناء التشغيل الفعلي عند استدعاء Status()، لا توجد رموز أخطاء أو استثناءات مخصصة؛ الطريقة هي noexcept وتضمن أمان الاستثناءات ([AP_SWS_SHWA_01409]). بالتالي، يُرجح أن يتم تمثيل تعطل العتاد أو فقدان الاتصال في قيمة الحالة المُعادة DeviceStatus. سؤال Q-8e2c8c2c7533b36f (مفتوح)
يستند هذا الدليل إلى محددات مواصفة AUTOSAR Adaptive Platform R25-11.
Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.
Scope
class ara::shwa::DeviceMonitor
Thread Safety
thread-safe rollback_semantics ShwaErrorCode::k Runtime General runtime error rollback_semantics ShwaErrorCode::k ResourceBusy The operation could not be performed because the resource is currently busy rollback_semantics ShwaErrorCode::kInvalid Parameter Invalid argument to an API function rollback_semantics
Exception Safety
exception safe
Errors
ShwaErrorCode::k FeatureNotSupported Used when a requested feature isn’t supported
Request a governed re-review of this record. The record is not changed immediately.
Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.
Scope
class ara::shwa::DeviceMonitor
Thread Safety
thread-safe rollback_semantics ShwaErrorCode::k Runtime General runtime error rollback_semantics ShwaErrorCode::k ResourceBusy The operation could not be performed because the resource is currently busy rollback_semantics ShwaErrorCode::kInvalid Parameter Invalid argument to an API function rollback_semantics
Exception Safety
exception safe
Errors
ShwaErrorCode::k FeatureNotSupported Used when a requested feature isn’t supported
Request a governed re-review of this record. The record is not changed immediately.
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني