DEENESPTFRRUARHIKOZHNL

فئة apext::sm::PowerStateInterface

[SWS_SM_71000] Upstream: RS_SM_00402

class PowerStateInterface {...};

class for power state coordination with OS

Header-Datei#include "apext/sm/power_state_interface.h"
Forwarding-Header#include "apext/sm/sm_fwd.h"
Scopenamespace apext::sm

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

ينسق حالات الطاقة مع نظام التشغيل ويُخطر State Management بأحداث الاستيقاظ.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 142a6058cb95 المصدر أسئلة مفتوحة (3)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

ينسق حالات الطاقة مع نظام التشغيل ويُخطر State Management بأحداث الاستيقاظ.

تنسق الواجهة كغلاف لنظام التشغيل (OS-Wrapper) حالات الطاقة بين State Management ونظام التشغيل ([SWS_SM_71000]). يقوم State Management عبرها بتسجيل معالجات رد الاتصال مسبقًا لأحداث الاستيقاظ وتمرير طلبات الحالة المحددة إلى نظام التشغيل ([SWS_SM_71001]). بعد إعادة التنشيط بنجاح، يمكن إلغاء تسجيل المعالج في غلاف نظام التشغيل. ويتمثل القيد الوظيفي الأساسي في أن جميع استدعاءات الطرق ليست آمنة لخيوط المعالجة، وبالتالي يجب على المستدعي تسلسلها بشكل إلزامي.

السياق

تعمل فئة C++‎ apext::sm::PowerStateInterface كواجهة وظيفية لوحدة State Management لتنسيق حالات الطاقة مع نظام التشغيل ([SWS_SM_71000]، SWS StateManagement §C.1.2 «Class: PowerStateInterface»). وفي بنية النظام، تتولى دور غلاف نظام التشغيل (OS-Wrapper) الذي يمرر طلبات State Management إلى نظام التشغيل الأساسي ويستقبل الردود. تشترك ثلاثة مكونات أساسية في التفاعل الكلي: State Management كجهة تنسيق، والفئة PowerStateInterface كوسيط، ونظام التشغيل المضيف الذي ينفذ إدارة الطاقة القريبة من العتاد ([SWS_SM_71001]).

sm State Management (SM) psi PowerStateInterface (OS-Wrapper) sm->psi Zustandsanforderung & Handler-Registrierung psi->sm WakeUpHandler-Aufruf os Betriebssystem (OS) psi->os Energiezustands- weiterleitung os->psi Aufwachsignal

مخطط السياق: تنسيق حالات الطاقة وإشارات الاستيقاظ بين State Management وغلاف نظام التشغيل ونظام التشغيل. المصادر: [SWS_SM_71000]، [SWS_SM_71001]، [SWS_SM_71003].

دورة الحياة

إن إنشاء وتدمير نسخ الفئة PowerStateInterface غير منظّم في وثائق المواصفة عبر دوال مصنع صريحة. ووفقًا للتفسير، يُرجح أن يتم إنشاء النسخ بواسطة State Management أثناء مرحلة التهيئة الخاصة به لتوفير غلاف نظام التشغيل. سؤال Q-15bde6ce044e9bc3 (مفتوح) لتضمين الفئة، خُصصت الترويسة apext/sm/power_state_interface.h ([SWS_SM_71001]، SWS StateManagement §C.1.2.1.1 «Member Functions»).

فيما يتعلق بالحالة الداخلية، يدير الكائن تسجيل معالج لأحداث الاستيقاظ. وتظل هذه الحالة نشطة حتى تتم إزالة المعالج صراحة ([SWS_SM_71005]). وبخصوص التزامن، تم تصنيف جميع دوال الأعضاء على أنها غير آمنة لخيوط المعالجة (not-threadsafe) ([SWS_SM_71001]، [SWS_SM_71003]، [SWS_SM_71005]). لذلك يجب على State Management المستدعي ضمان تسلسل الاستدعاءات إلى النسخة بصرامة بشكل مستقل وعدم حدوث وصول متوازٍ غير محمي من عدة خيوط معالجة.

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

يتم مسار استخدام نموذجي للتحكم في حالات الطاقة واستقبال إشارات الاستيقاظ عبر عدة خطوات متناسقة:

  • تسجيل المعالج: قبل الشروع في حالة توفير الطاقة، يسجل State Management دالة رد اتصال من النوع apext::sm::WakeUpHandler في غلاف نظام التشغيل باستخدام RegisterWakeUpHandler ([SWS_SM_71003]، SWS StateManagement §C.1.2.1.1.1 «RegisterWakeUpHandler»). يحدد هذا كيفية إخطار State Management بعمليات الاستيقاظ اللاحقة.
  • طلب الحالة: بعد ذلك، يستدعي State Management الطريقة SetPowerState مع الحالة المستهدفة المطلوبة apext::sm::PowerState ([SWS_SM_71001]، SWS StateManagement §C.1.2.1.1.2 «SetPowerState»). تُمرر الواجهة هذا الطلب مباشرة إلى نظام التشغيل. ويُفترض أن التنفيذ التقني للانتقال يتم بشكل خاص بالمنصة داخل نظام التشغيل. سؤال Q-29345b74ba3bedf2 (مفتوح)
  • إشعار الاستيقاظ: إذا اكتشف نظام التشغيل حدث استيقاظ، يتم إرسال الإشعار إلى غلاف نظام التشغيل. يقوم الأخير بتنفيذ WakeUpHandler المُسجَّل مسبقًا. ووفقًا للتفسير، يُرجح أن يتم الاستدعاء بشكل غير متزامن في سياق تنفيذ عملية إعادة التنشيط. سؤال (مفتوح)
  • إلغاء تسجيل المعالج: بمجرد اكتمال عملية الاستيقاظ أو عدم حاجة State Management إلى إشعارات إضافية، تتم إزالة رد الاتصال المُسجَّل من غلاف نظام التشغيل عبر UnregisterWakeUpHandler ([SWS_SM_71005]، SWS StateManagement §C.1.2.1.1.3 «UnregisterWakeUpHandler»).
تنسيق حالات الطاقة وإشارات الاستيقاظState Management (SM)PowerStateInterfaceBetriebssystem (OS)RegisterWakeUpHandler(handler)SetPowerState(state)Energiezustand weiterleitenUse Case: AufwachvorgangAufwachereignishandler()Use Case: BereinigungUnregisterWakeUpHandler()

مخطط التسلسل: المسار النموذجي لتسجيل المعالج، وإعادة توجيه الحالة إلى نظام التشغيل، وإلغاء التسجيل. المصادر: [SWS_SM_71001]، [SWS_SM_71003]، [SWS_SM_71005].

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

تمتلك طرق الواجهة RegisterWakeUpHandler وSetPowerState وUnregisterWakeUpHandler نوع الإرجاع void ولا تحدد رموز إرجاع أخطاء خاصة ([SWS_SM_71001]، [SWS_SM_71003]، [SWS_SM_71005]). جميع الدوال مُعلنة كـ noexcept وتضمن أمانًا تامًا من الاستثناءات (exception safe).

يمكن أن تنشأ حالات النظام الخاطئة بشكل أساسي من انتهاك الشروط المسبقة. ويشمل ذلك انتهاك أمان خيوط المعالجة المطلوب من خلال استدعاءات الطرق المتوازية غير المحمية. علاوة على ذلك، كشرط مسبق لـ RegisterWakeUpHandler، يجب على State Management التأكد من أن كائن الدالة المُمَرر صالح ويظل في الذاكرة حتى يتم إلغاؤه بواسطة UnregisterWakeUpHandler ([SWS_SM_71003]، [SWS_SM_71005]).

يستند هذا الدليل حصريًا إلى متطلبات مواصفة AUTOSAR Adaptive Platform الإصدار R25-11.

خريطة الأعضاء

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

3
RegisterWakeUpHandlerSetPowerStateUnregisterWakeUpHandler

مخطط الفئة

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

G napext__sm__PowerStateInterface528 PowerStateInterface + RegisterWakeUpHandler() + SetPowerState() + UnregisterWakeUpHandler()

عرض التفاصيل

اختر عنصرًا من المخطط.

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

RegisterWakeUpHandler دالة

Register wake-up handler function in the OS-Wrapper to inform SM about wake-up.

void RegisterWakeUpHandler (apext::sm::WakeUpHandler handler) noexcept; DIRECTION NOT handler -- DEFINED
SetPowerState دالة

Forward the power state request to OS.

void SetPowerState (apext::sm::PowerState state) noexcept; DIRECTION NOT state -- DEFINED
UnregisterWakeUpHandler دالة

Unregister wake-up handler in OS-Wrapper.

void UnregisterWakeUpHandler () noexcept;

توثيق الدوال

دالة RegisterWakeUpHandler [SWS_SM_71003] Upstream: RS_SM_00402

void RegisterWakeUpHandler (apext::sm::WakeUpHandler handler) noexcept; DIRECTION NOT           handler                    -- DEFINED

Register wake-up handler function in the OS-Wrapper to inform SM about wake-up.

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

تُستخدم الدالة RegisterWakeUpHandler للفئة apext::sm::PowerStateInterface لتسجيل دالة رد نداء من النوع apext::sm::WakeUpHandler في مغلّف OS لإخطار State Management (SM) بأحداث الإيقاظ [SWS_SM_71003]. تم تعريف الواجهة في الترويسة #include "apext/sm/power_state_interface.h" وتلبي المتطلب ذو المستوى الأعلى [RS_SM_00402] AUTOSAR_AP_SWS_StateManagement §C.1.2.1.1.1 «RegisterWakeUpHandler».

الاستخدام وسياق الاستدعاء

التصريح هو void RegisterWakeUpHandler (apext::sm::WakeUpHandler handler) noexcept [SWS_SM_71003]. يتم الاستدعاء بشكل متزامن لتمرير مؤشر الدالة أو رد النداء عبر المعامل handler. ونظرًا لأن الدالة لا تمتلك قيمة إرجاع (void)، فإنها لا تقدم إفادة حالة حول اكتمال التسجيل [SWS_SM_71003].

معالجة الأخطاء والأمان من الاستثناءات

تم تحديد الواجهة على أنها آمنة من الاستثناءات (exception safe) وتم تذييلها بـ noexcept [SWS_SM_71003]. وبالتالي، لا يحتاج المستدعون إلى اعتراض استثناءات C++. لا توجد أكواد خطأ محددة، أو قيم إرجاع للإشارة إلى الخطأ، أو رسائل إلى مديري التشخيص أو الأخطاء محددة لـ API هذه [SWS_SM_71003].

التزامن والقيود

  • الأمان الخيطي: صُنفت الدالة صراحةً على أنها غير آمنة خيطيًا (not-threadsafe) [SWS_SM_71003]. يجب على النسخ المستدعية التأكد من عدم حدوث الاستدعاءات بدون حماية من خيوط متنافسة. تفسير: يُرجح أن يتم التسجيل لمرة واحدة على نحو ملائم خلال مرحلة التهيئة التسلسلية لمغلّف OS، قبل حدوث أحداث الإيقاظ. سؤال Q-268ab61374f98e7a (مفتوح)
  • حالة التطوير: يمتلك تعريف الدالة في الإصدار R25-11 الحالة DRAFT AUTOSAR_AP_SWS_StateManagement §C.1.2.1.1.1 «RegisterWakeUpHandler»، ولهذا السبب قد تقع تعديلات في نسخ المواصفة المستقبلية.

تم توليد ملاحظة الاستخدام هذه آلياً بالاستناد إلى مواصفة AUTOSAR للإصدار R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "apext/sm/power_state_interface.h"
Scopeclass apext::sm::PowerStateInterface
Exception-Sicherheitexception safe
Thread-Sicherheitnot-threadsafe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_SM_71003
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_71003@rel:R25-11#4ed2ded5
Content hash
4ed2ded5
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_71003
Status: valid/unmigrated Version: rel:R25-11#bc05c3e2 Versionshistorie & Revisions (1 transition)
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_SM_71003@rel:R25-11#bc05c3e2
Point-in-Time History:
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

دالة SetPowerState [SWS_SM_71001] Upstream: RS_SM_00402

void SetPowerState (apext::sm::PowerState state) noexcept; DIRECTION NOT           state                      -- DEFINED

Forward the power state request to OS.

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

تُستخدم دالة العضو SetPowerState للفئة apext::sm::PowerStateInterface لإعادة توجيه طلب لتغيير حالة طاقة النظام إلى نظام التشغيل [SWS_SM_71001]. وهي تنفذ المتطلب ذو المستوى الأعلى [RS_SM_00402] وتتوفر عبر الترويسة apext/sm/power_state_interface.h (SWS StateManagement §C.1.2.1.1.2 «SetPowerState»).

تنطبق الشروط الإطارية التالية على الاستخدام والدمج في سياق الاستدعاء:

  • المعاملات وقيمة الإرجاع: تأخذ الدالة الحالة المستهدفة state من النوع apext::sm::PowerState بالقيمة. ولا توجد قيمة إرجاع (void) [SWS_SM_71001].
  • أمان الاستثناءات ومعالجة الأخطاء: تم التصريح عن العملية كـ noexcept وتُعتبر آمنة من الاستثناءات (exception safe) [SWS_SM_71001]. ونظرًا لعدم توفير أكواد خطأ أو استثناءات محددة، يُرجح أن تتم معالجة الطلب في نظام التشغيل بشكل غير متزامن. سؤال Q-03a3ae7693c3cfee (مفتوح)
  • التزامن: واجهة الدالة مصنفة على أنها غير آمنة خيطيًا (not-threadsafe) [SWS_SM_71001]. يجب تأمين الاستدعاءات المتزامنة على نفس النسخة من قِبل المستدعي عبر تدابير مزامنة خارجية.
  • حالة المواصفة: تم تمييز الواجهة بالحالة DRAFT (SWS StateManagement §C.1.2.1.1.2 «SetPowerState»)، ولهذا السبب قد تحدث تعديلات مستقبلية على التوقيع أو السلوك.

تم إنشاء ملاحظة الاستخدام هذه آليًا وتستند إلى مواصفة AUTOSAR Adaptive Platform الإصدار R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "apext/sm/power_state_interface.h"
Scopeclass apext::sm::PowerStateInterface
Exception-Sicherheitexception safe
Thread-Sicherheitnot-threadsafe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_SM_71001
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_71001@rel:R25-11#e4ee6499
Content hash
e4ee6499
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_71001
Status: valid/unmigrated Version: rel:R25-11#be2610a0 Versionshistorie & Revisions (1 transition)
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_SM_71001@rel:R25-11#be2610a0
Point-in-Time History:
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

دالة UnregisterWakeUpHandler [SWS_SM_71005] Upstream: RS_SM_00402

void UnregisterWakeUpHandler () noexcept;

Unregister wake-up handler in OS-Wrapper.

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

الاستخدام وسياق الاستدعاء

تنتمي الدالة UnregisterWakeUpHandler لنطاق الفئة apext::sm::PowerStateInterface وتتوفر عبر ملف الترويسة #include "apext/sm/power_state_interface.h" [SWS_SM_71005]. والغرض منها هو إلغاء تسجيل معالج الإيقاظ الذي تم إعداده مسبقًا في مغلّف OS [SWS_SM_71005]. يتم الاستدعاء بشكل متزامن، ولا يتطلب أي معاملات تمرير، وليس له قيمة إرجاع (void) [SWS_SM_71005].

معالجة الأخطاء

تم التصريح عن العملية بالمعرّف noexcept وتم تحديدها على أنها آمنة من الاستثناءات (exception safe) [SWS_SM_71005]. لم يتم تعريف أكواد خطأ محددة أو مدخلات DEM أو DET. تفسير: نظرًا لغياب نوع الإرجاع أو مؤشرات الخطأ، يُرجح ألا تبلغ الدالة المستدعي مباشرةً بأي أخطاء داخلية في مغلّف OS. سؤال Q-0d692808f97a0fb5 (مفتوح)

التزامن والشروط الحدية

فيما يتعلق ببيئة التنفيذ، تم تصنيف UnregisterWakeUpHandler صراحةً على أنها غير آمنة خيطيًا (not-threadsafe) [SWS_SM_71005]. يجب ألا تتم الاستدعاءات المتزامنة من خيوط متعددة دون حماية ويجب مزامنتها من جانب التطبيق.

التفاعل وحالة المواصفة

تُستخدم الدالة لتلبية المتطلب ذو المستوى الأعلى RS_SM_00402 AUTOSAR_AP_SWS_StateManagement §C.1.2.1.1.3 «UnregisterWakeUpHandler». وعند الدمج، يجب مراعاة أن تعريف الواجهة في المواصفة الحالية لا يزال يحمل الحالة DRAFT AUTOSAR_AP_SWS_StateManagement §C.1.2.1.1.3 «UnregisterWakeUpHandler».

تم إنشاء ملاحظة الاستخدام هذه آليًا استنادًا إلى AUTOSAR R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "apext/sm/power_state_interface.h"
Scopeclass apext::sm::PowerStateInterface
Exception-Sicherheitexception safe
Thread-Sicherheitnot-threadsafe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_SM_71005
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_71005@rel:R25-11#ceb43009
Content hash
ceb43009
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_71005
Status: valid/unmigrated Version: rel:R25-11#ef4ae762 Versionshistorie & Revisions (1 transition)
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_SM_71005@rel:R25-11#ef4ae762
Point-in-Time History:
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