DEENESPTFRRUARHIKOZHNL

नेमस्पेस apext::sm

उपयोगकर्ता गाइडएआई जनित

ऑपरेटिंग सिस्टम की ऊर्जा स्थितियों के हार्डवेयर-निकट समन्वय और State Management में स्वायत्त वेक-अप को सक्षम बनाता है।
एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 8273631beee4 उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

ऑपरेटिंग सिस्टम की ऊर्जा स्थितियों के हार्डवेयर-निकट समन्वय और State Management में स्वायत्त वेक-अप को सक्षम बनाता है।

नेमस्पेस apext::sm AUTOSAR Adaptive State Management और होस्ट ऑपरेटिंग सिस्टम के बीच ऊर्जा स्थितियों के समन्वय के लिए मानक प्लेटफ़ॉर्म विस्तार इंटरफ़ेस प्रदान करता है SWS StateManagement §C.1 “Header: apext/sm/power_state_interface.h”। एन्यूमरेशन apext::sm::PowerState के माध्यम से, Linux-विशिष्ट ऊर्जा बचत मोड को टाइप्ड रूप में दर्शाया जाता है [SWS_SM_71002]। इसके अतिरिक्त, कॉलबैक apext::sm::WakeUpHandler ऑपरेटिंग सिस्टम को किसी पूर्ववर्ती नियंत्रण ऐप्लिकेशन के बिना State Management में स्लीप स्टेट्स से स्वायत्त निकास को ट्रिगर करने में सक्षम बनाता है [SWS_SM_71004], जहाँ यह कॉल थ्रेड-सुरक्षित नहीं बनाया गया है।

संदर्भ

नेमस्पेस apext::sm AUTOSAR Adaptive Platform के भीतर कार्यात्मक क्लस्टर State Management के लिए मानक प्लेटफ़ॉर्म विस्तार इंटरफ़ेस (Platform Extension Interfaces) प्रदान करता है SWS StateManagement §C.1 “Header: apext/sm/power_state_interface.h”। जबकि State Management के मानक इंटरफ़ेस मुख्य रूप से मॉडल सीमाओं के पार ऐप्लिकेशन स्थितियों, फ़ंक्शन समूहों और निष्पादन मोड के समन्वय का कार्य करते हैं, apext::sm हार्डवेयर-निकट युग्मन को संबोधित करता है। एक्सटेंशन इंटरफ़ेस प्लेटफ़ॉर्म की कार्यक्षमता का विस्तार करने और अंतर्निहित ऑपरेटिंग सिस्टम (OS) के साथ समन्वित इंटरैक्शन को साकार करने के लिए OEMs या इंटीग्रेटर्स द्वारा उपयोग किए जाने या प्रदान किए जाने के लिए डिज़ाइन किए गए हैं SWS StateManagement §C.1 “Header: apext/sm/power_state_interface.h”।

नेमस्पेस का केंद्रीय घटक वर्ग PowerStateInterface है, जो ऑपरेटिंग सिस्टम के साथ ऊर्जा स्थितियों के समन्वय का कार्य करता है। साथ में, हेडर apext/sm/power_state_interface.h टाइप्ड एन्यूमिरेशन्स और कॉलबैक उपनामों को परिभाषित करता है, जो ऑपरेटिंग सिस्टम ड्राइवरों, बाहरी वेक-अप स्रोतों और आंतरिक स्थिति प्रबंधन के बीच एक कड़ी के रूप में कार्य करते हैं। ऑपरेटिंग सिस्टम के अलावा, ये इंटरफ़ेस वैचारिक रूप से State Management के Controller के साथ-साथ उच्च-स्तरीय घटकों जैसे SMControlApplication या Update and Configuration Management (UCM) से संबंधित हैं, जो स्थिति संक्रमणों को भी प्रभावित कर सकते हैं SWS StateManagement §7.7.15.1 “Autonomous wake-up from suspend state”।

OS Betriebssystem (Kernel) ApextSM apext::sm (PowerStateInterface, WakeUpHandler) OS->ApextSM Signalisiert Wake-up Setzt PowerState SMController State Management (Controller) ApextSM->SMController Autonomer Aufruf (WakeUpHandler) SMControlApp SMControlApplication / UCM SMControlApp->SMController Explizite Requests (RequestUpdateSession)

संदर्भ आरेख (Context diagram): ऑपरेटिंग सिस्टम, apext::sm-इंटरफ़ेस और State Management की परस्पर क्रिया। स्रोत: SWS StateManagement §7.7.15.1 “Autonomous wake-up from suspend state”, SWS StateManagement §C.1 “Header: apext/sm/power_state_interface.h”।

जीवनचक्र

apext::sm के संदर्भ में जीवनचक्र असतत ऊर्जा स्थितियों द्वारा चिह्नित है, जो std::uint32_t के आधार पर एन्यूमरेशन apext::sm::PowerState में मॉडल किए गए हैं [SWS_SM_71002]। ये स्थितियाँ सीधे Linux ऑपरेटिंग सिस्टम के कर्नेल दृष्टिकोण से ली गई हैं:

  • kPmSuspendToIdle (= 1): स्थिति PM_SUSPEND_TO_IDLE [SWS_SM_71002] से व्युत्पन्न।
  • kPmSuspendToRam (= 2): स्थिति PM_SUSPEND_TO_RAM [SWS_SM_71002] से व्युत्पन्न।
  • kPmHibernation (= 3): स्थिति PM_HIBERNATION (Suspend-to-Disk) [SWS_SM_71002] से व्युत्पन्न।
  • kPmOff (= 4): स्थिति PM_OFF (पूर्ण शटडाउन) [SWS_SM_71002] से व्युत्पन्न।

Interpretation: वर्ग PowerStateInterface संभवतः प्राथमिक एंकर बिंदु के रूप में कार्य करता है, जिसके माध्यम से इंटीग्रेटर इन लक्ष्य स्थितियों की क्वेरी करता है या उन्हें होस्ट ऑपरेटिंग सिस्टम तक पहुँचाता है। प्रश्न Q-800acae699828764 (खुला) kPmSuspendToRam जैसी ऊर्जा बचत स्थिति में बने रहने के दौरान, सामान्य प्रोसेसिंग तब तक रुकी रहती है जब तक कि कोई वेक-अप इवेंट सक्रिय ऑपरेटिंग मोड में वापस संक्रमण शुरू नहीं करता।

उपयोग पथ

नेमस्पेस का एक केंद्रीय उपयोग मामला स्लीप स्टेट से संपूर्ण सिस्टम का स्वायत्त वेक-अप (Autonomous wake-up from suspend state) है SWS StateManagement §7.7.15.1 “Autonomous wake-up from suspend state”। जबकि एक SMControlApplication Suspend-to-RAM मोड से बाहर निकलने का स्पष्ट अनुरोध कर सकता है, State Management इसके अतिरिक्त वेक-अप संकेतों पर स्वायत्त रूप से प्रतिक्रिया करने में सक्षम है।

यदि ऑपरेटिंग सिस्टम इंटरफ़ेस apext::sm::WakeUpHandler के माध्यम से एक वेक-अप इवेंट का संकेत देता है – बशर्ते इसे कार्यान्वित किया गया हो –, तो State Management स्वतंत्र रूप से एक वेक-अप अनुक्रम शुरू करता है SWS StateManagement §7.7.15.1 “Autonomous wake-up from suspend state”। apext::sm::WakeUpHandler प्रकार std::function<void(void)> [SWS_SM_71004] का एक फ़ंक्शन उपनाम है। इस हैंडलर को कॉल करके, State Management Controller-स्टेट मशीन को उसकी सस्पेंड स्थिति से विशेष रूप से इसके लिए मॉडल की गई स्थिति LeaveSuspend [SWS_SM_CONSTR_00036] में स्थानांतरित करता है। इस स्थिति में, नियंत्रक अनिवार्य रूप से एक्शन तत्व LeaveSuspendToRam को निष्पादित करता है, जिससे किसी नियंत्रण ऐप्लिकेशन के पूर्व हस्तक्षेप के बिना नियमित प्लेटफ़ॉर्म गतिविधि फिर से शुरू हो जाती है [SWS_SM_CONSTR_00037], SWS StateManagement §7.7.15.1 “Autonomous wake-up from suspend state”।

Suspend-to-RAM से स्वायत्त वेक-अपBetriebssystemapext::sm::WakeUpHandlerState Management (Controller)Use Case: वेक-अप सिग्नल को ट्रिगर करनाWake-up signalisierenAufruf operator()Use Case: स्वायत्त अवस्था संक्रमण (Autonomous state transition)LeaveSuspend के बाद अवस्था परिवर्तनActionListItem LeaveSuspendToRam को निष्पादित करनाNormalbetrieb aktiv

अनुक्रम आरेख (Sequence diagram): WakeUpHandler के माध्यम से स्वायत्त वेक-अप का प्रवाह। स्रोत: SWS StateManagement §7.7.15.1 “Autonomous wake-up from suspend state”, [SWS_SM_71004], [SWS_SM_CONSTR_00036], [SWS_SM_CONSTR_00037]।

त्रुटि परिदृश्य

apext::sm के उपयोग और एकीकरण में, सिस्टम-विशिष्ट बाधाओं और समवर्तीता जोखिमों पर ध्यान दिया जाना चाहिए:

  • थ्रेड-सुरक्षा का अभाव: विनिर्देश के अनुसार कॉल प्रकार apext::sm::WakeUpHandler स्पष्ट रूप से गैर-थ्रेड-सुरक्षित (not thread-safe) है [SWS_SM_71004]। यदि ऑपरेटिंग सिस्टम या इंटरप्ट संदर्भ एकाधिक या समानांतर संकेत ट्रिगर करता है, तो इंटीग्रेटर को डेटा रेस और State Management में असंगत स्थिति संक्रमणों को रोकने के लिए उपयुक्त सिंक्रनाइज़ेशन तंत्र प्रदान करना होगा।
  • गैर-कार्यान्वित हैंडलर: यदि लक्षित सिस्टम में WakeUpHandler कार्यान्वित नहीं है, तो ऑपरेटिंग सिस्टम के माध्यम से कोई स्वायत्त वेक-अप नहीं हो सकता; इस मामले में, सिस्टम स्लीप स्टेट में तब तक बना रहता है जब तक कि बाहरी अनुरोध (जैसे RequestUpdateSession के माध्यम से UCM द्वारा) या स्पष्ट ऐप्लिकेशन अनुरोध प्राप्त नहीं होते SWS StateManagement §7.7.15.1 “Autonomous wake-up from suspend state”।
  • मैनिफ़ेस्ट में मॉडलिंग त्रुटि: यदि डिप्लॉयमेंट मैनिफ़ेस्ट में Controller [SWS_SM_CONSTR_00036] के लिए स्थिति LeaveSuspend अनुपस्थित है या इसमें अनिवार्य तत्व LeaveSuspendToRam [SWS_SM_CONSTR_00037] शामिल नहीं है, तो स्वचालित संक्रमण विफल हो जाता है और प्लेटफ़ॉर्म स्लीप स्टेट के बाद विनिर्देश के अनुसार संचालन फिर से शुरू नहीं कर पाता है।

यह मार्गदर्शिका विनिर्देश AUTOSAR Adaptive Platform R25-11 पर आधारित है। सभी सामग्रियों को State Management के लिए मानक Platform Extension Interfaces के आधार पर मान्य किया गया है।

विषय मानचित्र

क्लासें

1
PowerStateInterface

टाइप और स्थिरांक

2
PowerStateWakeUpHandler

क्लास आरेख

Abgerundete Rahmen = Namespace- bzw. Klassen-Scopes; hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); graue Boxen = namespace-fremde bzw. externe Basisklassen. Klicken öffnet die jeweilige Klassen- bzw. cppreference-Seite.

G cluster_ns apext::sm napext__sm__PowerStateInterface PowerStateInterface

विवरण दृश्य

रूपरेखा में कोई प्रविष्टि चुनें।

क्लासें

PowerStateInterface क्लास

class for power state coordination with OS

टाइप और स्थिरांक

PowerState एन्यूमरेशन

Power State Enumeration.

enum class PowerState : std::uint32_t {...};
WakeUpHandler टाइप उपनाम

WakeUpHandler function.

using WakeUpHandler = std::function<void(void)>;

एन्यूमरेशन

एन्यूमरेशन PowerState [SWS_SM_71002] Upstream: RS_SM_00402

enum class PowerState :         std::uint32_t {...};

Power State Enumeration.

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

Werte

EnumeratorBeschreibung
kPmSuspendToIdle=1 Derived from Linux Power State PM_SUSPEND_TO_IDLE (Kernel view)
kPmSuspendToRam=2 Derived from Linux Power State PM_SUSPEND_TO_RAM (Kernel view)
kPmHibernation=3 Derived from Linux Power State PM_HIBERNATION (Kernel view)
kPmOff=4 Derived from Linux Power State PM_OFF (Kernel view)

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

Record
AUTOSAR/AP/record/SWS_SM_71002
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_71002@rel:R25-11#048e773a
Content hash
048e773a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_71002
Status: valid/unmigrated Version: rel:R25-11#4f68e3fd 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_71002@rel:R25-11#4f68e3fd
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

टाइप उपनाम

टाइप उपनाम WakeUpHandler [SWS_SM_71004] Upstream: RS_SM_00402

using WakeUpHandler = std::function<void(void)>;

WakeUpHandler function.

Header-Datei#include "apext/sm/power_state_interface.h"
Scopenamespace apext::sm
SymbolWakeUpHandler
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_SM_71004
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_71004@rel:R25-11#ceec91e5
Content hash
ceec91e5
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_71004
Status: valid/unmigrated Version: rel:R25-11#29968d23 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_71004@rel:R25-11#29968d23
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