DEENESPTFRRUARHIKOZHNL

فئة apext::phm::WatchdogInterface

[SWS_PHM_01257] Upstream: RS_PHM_00101

class WatchdogInterface {...};

class for interface to hardware watchdog Note: class WatchdogInterface although identifiable in code as an interface, it is a PlatformExtension - i.e. no modelled interface - nothing to do here

Header-Datei#include "apext/phm/watchdog_interface.h"
Forwarding-Header#include "apext/phm/phm_fwd.h"
Scopenamespace apext::phm

دليل المستخدممولَّد بالذكاء الاصطناعي

يربط التحكم في Hardware Watchdog والاستجابة للأخطاء بـ Platform Health Management.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: ead3ce845973 المصدر أسئلة مفتوحة (3)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يربط التحكم في Hardware Watchdog والاستجابة للأخطاء بـ Platform Health Management.

تشكل الفئة apext::phm::WatchdogInterface كامتداد للمنصة الواجهة بين Platform Health Management وHardware Watchdog الفعلي. يُخطر PHM الواجهة دوريًا في التشغيل العادي عبر AliveNotification()، حيث يجب على الواجهة إطلاق استجابة Watchdog ذاتيًا في حال غياب الإشعار [SWS_PHM_01255]. وفي حالة أخطاء النظام الحرجة، يمكن لـ PHM أيضًا عبر FireWatchdogReaction() فرض استجابة خطأ مباشرة من أجهزة Watchdog [SWS_PHM_01256]. وكقيد أساسي، تم تحديد كلتا الطريقتين على أنهما آمنتان من الخيوط (threadsicher)، ولكنهما ليستا آمنتين من الاستثناءات.

السياق

تمثل فئة C++ apext::phm::WatchdogInterface في Platform Health Management (PHM) لـ AUTOSAR Adaptive الواجهة مع عتاد Watchdog الفعلي. وكامتداد للمنصة (PlatformExtension)، فإنها لا تمثل واجهة منفذ AUTOSAR مصممة، بل تعمل كجسر خاص بالشركة المصنعة بين خدمة PHM والعتاد الأساسي. يراقب PHM تنفيذ العمليات ومكونات المنصة. ولتأمين فشل أو حظر خدمة PHM نفسها بشكل موثوق أيضًا، يربط WatchdogInterface المراقبة العتادية الخارجية أو الداخلية. عبر الدالة AliveNotification()، يبلغ PHM دوريًا عن قدرته الوظيفية إلى الواجهة [SWS_PHM_01255]. وإذا حدث خطأ حرج في النظام، يمكن لـ PHM عبر الدالة FireWatchdogReaction() طلب استجابة الخطأ من جهة العتاد بشكل محدد [SWS_PHM_01256].

WatchdogKontext PHM PHM WatchdogInterface WatchdogInterface PHM->WatchdogInterface AliveNotification() / FireWatchdogReaction() HardwareWatchdog HardwareWatchdog WatchdogInterface->HardwareWatchdog Triggerung / Watchdog-Reaktion

مخطط السياق: دمج WatchdogInterface بين PHM وHardware Watchdog. المصادر: [SWS_PHM_01255]، [SWS_PHM_01256]

دورة الحياة

نظرًا لأن apext::phm::WatchdogInterface تعمل كامتداد للمنصة، يُرجح أن يتم إنشاء مثيل تنفيذ الواجهة والربط ببرنامج تشغيل العتاد بصورة مخصصة للمنصة أثناء تهيئة خدمة PHM. سؤال Q-c2235d5c87e0a675 (مفتوح) ويكون العمر الافتراضي للمثيل مرتبطًا عادةً بوقت تشغيل PHM، بحيث لا يُتوقع وجود دورة حياة ديناميكية تتضمن إنشاءً أو تدميرًا متكررًا أثناء تشغيل المنصة. وفيما يتعلق بالتزامن، تم الإعلان صراحةً عن دالتي الواجهة AliveNotification() وFireWatchdogReaction() على أنهما آمنتان من الخيوط (thread-safe) [SWS_PHM_01255]، [SWS_PHM_01256]. يتيح ذلك لـ PHM تمرير إشارات الحياة ورسائل الأخطاء من خيوط عمل داخلية مختلفة بالتوازي ودون مزامنة من جانب المستدعي إلى واجهة Watchdog.

مسار الاستخدام

ينقسم التفاعل النموذجي بين PHM والواجهة إلى دورة المراقبة العادية وتصعيد الأخطاء:

  • الإبلاغ الدوري عن إشارات الحياة: يستدعي PHM AliveNotification() بشكل متكرر ضمن زمن دورة مهيأ [SWS_PHM_01255]. ولا يلزم أن يتطابق زمن الدورة هذا مع فترة التحفيز الحقيقية للعتاد؛ ويُرجح أن يقوم التنفيذ داخليًا بتخزين الفواصل الزمنية مؤقتًا أو تحجيمها للتحكم في Watchdog الفعلي [SWS_PHM_01255]. سؤال Q-a6c08f102f09c8c1 (مفتوح)
  • تحفيز العتاد: يضمن WatchdogInterface خدمة وحدة Hardware Watchdog في الوقت المحدد عند ورود الإخطارات المنتظمة.
  • إشارة خطأ محددة: إذا اكتشف PHM حالة غير قابلة للإصلاح (unrecoverable) في الكيانات الخاضعة للمراقبة، فإنه يستدعي مباشرة FireWatchdogReaction() [SWS_PHM_01256].
المراقبة الدورية وإطلاق استجابة مراقب التوقفPHMWatchdogInterfaceHardware-WatchdogUse Case: دورة المراقبة المنتظمةloopKonfigurierte ZykluszeitAliveNotification()Hardware-Watchdog bedienenUse Case: FehlerfallaltPHM fordert Fehlerreaktion anFireWatchdogReaction()إطلاق استجابة مراقب التوقفغياب رسالة البقاء قيد الحياة (مهلة زمنية)Timeout erkennenإطلاق استجابة مراقب التوقف

مخطط التسلسل: النقل المنتظم لإشارات الحياة وإطلاق استجابة Watchdog. المصادر: [SWS_PHM_01255]، [SWS_PHM_01256]

سيناريوهات الأخطاء

تدعم الواجهة آليتين متكاملتين لمعالجة فشل النظام:

من ناحية، يؤدي الغياب السلبي للإخطارات إلى استجابة النظام: إذا لم يُرسل PHM إخطارًا خلال الفترة الزمنية المهيأة عبر AliveNotification()، فإن WatchdogInterface ملزم ببدء استجابة Watchdog ذاتيًا [SWS_PHM_01255]. يؤدي هذا إلى اعتراض أعطال أو حالات الجمود لخدمة PHM نفسها بشكل موثوق بواسطة العتاد.

ومن ناحية أخرى، يتوفر مسار الأخطاء النشط: عبر الاستدعاء الصريح لـ FireWatchdogReaction()، يتم إطلاق استجابة خطأ محددة لـ Watchdog [SWS_PHM_01256]. وفي كلتا الحالتين، يُرجح عادةً أن يتمثل التأثير النهائي على مستوى النظام في إعادة تعيين العتاد أو الانتقال إلى حالة آمنة. سؤال Q-817baa072cc94a19 (مفتوح)

فيما يتعلق بسلوك الأخطاء في الكود، تم تحديد دالتي الأعضاء على أنهما غير آمنتين من حيث الاستثناءات (not exception safe) [SWS_PHM_01255]، [SWS_PHM_01256]. وبالتالي، لا يمكن للمكون المستدعي الاعتماد على أي ضمانات لمعالجة الاستثناءات، ولا يجوز لتنفيذ الواجهة إطلاق أي استثناءات C++ غير معالجة.

يلخص هذا الدليل مواصفات apext::phm::WatchdogInterface وفقًا لـ AUTOSAR Adaptive R25-11.

مخطط الفئات UML

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G napext__phm__WatchdogInterface47 WatchdogInterface + AliveNotification() + FireWatchdogReaction()

الدوال الأعضاء

AliveNotification دالة

Called cyclically by PHM in configurable cycle time. Note: This time might differ from the cycle time of triggering the "real" hardware watchdog. If PHM does not report aliveness in configured time, WatchdogInterface shall initiate watchdog reaction

void AliveNotification ();
FireWatchdogReaction دالة

Interface to fire an error reaction of the Watchdog.

void FireWatchdogReaction ();

توثيق الدوال

دالة AliveNotification [SWS_PHM_01255] Upstream: RS_PHM_00101, RS_PHM_09240

void AliveNotification ();

Called cyclically by PHM in configurable cycle time. Note: This time might differ from the cycle time of triggering the "real" hardware watchdog. If PHM does not report aliveness in configured time, WatchdogInterface shall initiate watchdog reaction

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: cb75c45d42c3 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تنتمي الدالة AliveNotification من الترويسة apext/phm/watchdog_interface.h إلى الفئة apext::phm::WatchdogInterface وتُستخدم للمراقبة الدورية للحيوية الخاصة بـ Platform Health Management (PHM) [SWS_PHM_01255]. تمتلك الواجهة التوقيع void AliveNotification()، ولا تقبل معاملات ولا تُرجع أي قيمة [SWS_PHM_01255].

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

يتم استدعاء AliveNotification دوريًا بواسطة PHM في زمن دورة قابل للتهيئة [SWS_PHM_01255]. هذا التردد في الاستدعاء مفصول منطقيًا عن تشغيل كلب الحراسة العتادي الفعلي، بحيث يمكن أن تختلف الفترة المهيأة لـ PHM عن وقت إطلاق كلب الحراسة العتادي [SWS_PHM_01255].

الاستجابة للأخطاء وسيناريوهات الفشل

إذا لم يبلغ PHM عن حيويته بنجاح خلال الفاصل الزمني المهيأ لذلك، يتم توجيه WatchdogInterface لبدء استجابة كلب الحراسة [SWS_PHM_01255]. لا توجد أكواد خطأ محددة مخصصة. تفسير: نظرًا لتصنيف الواجهة على أنها غير آمنة من الاستثناءات، يُرجح أن تنتشر حالات الخطأ غير المتوقعة كاستثناءات C++ إلى سياق المستدعي [SWS_PHM_01255]. سؤال Q-a9e59a992db9913f (مفتوح)

التزامن وأمان الاستثناءات

الدالة محددة على أنها آمنة خيطيًا (thread-safe)، ولهذا السبب يُسمح بعمليات الوصول المتوازية، ولكنها تُعتبر غير آمنة من الاستثناءات (not exception safe) [SWS_PHM_01255].

تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويلخص حالة مواصفة AUTOSAR Adaptive R25-11.

Header-Datei#include "apext/phm/watchdog_interface.h"
Scopeclass apext::phm::WatchdogInterface
Exception-Sicherheitnot exception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
None

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_PHM_01255
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PHM_01255@rel:R25-11#27036508
Content hash
27036508
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01255
Status: valid/unmigrated Version: rel:R25-11#3204f230 Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_PHM_01255@rel:R25-11#3204f230
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#756ef89a2026-09-30
  • R24-11rel:R24-11#b0affe0c2026-10-14
  • R25-11rel:R25-11#3204f2302026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة FireWatchdogReaction [SWS_PHM_01256] Upstream: RS_PHM_00101

void FireWatchdogReaction ();

Interface to fire an error reaction of the Watchdog.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 28a89e0724c4 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة FireWatchdogReaction كواجهة مخصصة داخل وحدة Platform Health Management (PHM) لإطلاق استجابة خطأ مستهدفة لكلب الحراسة [SWS_PHM_01256]. وهي مخصصة لنطاق الفئة apext::phm::WatchdogInterface ويتم توفيرها عبر ملف الترويسة apext/phm/watchdog_interface.h [SWS_PHM_01256].

عند الاستخدام، ينبغي مراعاة الجوانب التالية:

  • الاستدعاء والواجهة: مع التوقيع void FireWatchdogReaction ();، لا تقبل الدالة معاملات تمرير ولا تقدم قيمة إرجاع [SWS_PHM_01256]. يطلق الاستدعاء استجابة الخطأ لكلب الحراسة مباشرةً.
  • التزامن: تم تحديد العملية كـ thread-safe [SWS_PHM_01256]. وبناءً على ذلك، يجوز استدعاؤها بشكل متزامن من خيوط متعددة دون مزامنة خارجية إضافية.
  • أمان الاستثناءات ومعالجة الأخطاء: تم التصريح عن الدالة كـ not exception safe [SWS_PHM_01256]. تفسير: نظرًا لعدم ضمان أمان الاستثناءات، يُرجح أن تنتشر الاستثناءات التي تحدث في حالة الخطأ مباشرةً إلى المستدعي، ولهذا ينبغي أن يكون مستعدًا للاستثناءات المحتملة. سؤال Q-f53d689332369cd7 (مفتوح)

وبذلك توفر الدالة نقطة وصول قياسية للتدخل بفعالية في سلوك كلب الحراسة عند حدوث أخطاء جسيمة وبدء تدابير الحماية المحددة [SWS_PHM_01256].

تم إنشاء هذا النص بواسطة ذكاء اصطناعي. وهو يستند إلى AUTOSAR Adaptive R25-11.

Header-Datei#include "apext/phm/watchdog_interface.h"
Scopeclass apext::phm::WatchdogInterface
Exception-Sicherheitnot exception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
None

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_PHM_01256
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PHM_01256@rel:R25-11#ae7ee7be
Content hash
ae7ee7be
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01256
Status: valid/unmigrated Version: rel:R25-11#9d382947 Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_PHM_01256@rel:R25-11#9d382947
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#8b20aac12026-09-30
  • R24-11rel:R24-11#e80c13872026-10-14
  • R25-11rel:R25-11#9d3829472026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill