DEENESPTFRRUARHIKOZHNL

نطاق أسماء ara::nm

Diese Seite wurde vollständig KI-generiert auf Basis von SWS NetworkManagement (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.

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

يتيح التحكم في حالة الشبكة المطلوبة والفعلية بالإضافة إلى معالجة معيارية للأخطاء.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 602561c10e10 المصدر أسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يتيح التحكم في حالة الشبكة المطلوبة والفعلية بالإضافة إلى معالجة معيارية للأخطاء.

يوفر فضاء الأسماء ara::nm باستخدام NetworkHandle واجهات للوصول المتحكم فيه إلى حالة الشبكة المطلوبة والفعلية لـ AUTOSAR Adaptive Platform. يتم تمثيل حالات الخطأ المحتملة في سير العمل التشغيلي عبر رموز الخطأ المعيارية للتعداد NmErrc مثل kServiceNotAvailable أو kInvalidHandler [SWS_ANM_01111]. ولمعالجة منظمة للأخطاء، يُنشئ MakeErrorCode رموز خطأ آمنة لولبيًا لنطاق الخطأ NmErrorDomain، والذي يُشار إليه عبر GetNmDomain [SWS_ANM_01109]. يجب على التطبيقات مراعاة إمكانية الوصول إلى خدمة إدارة الشبكة قبل الاستدعاءات لتجنب حالات الفشل أثناء الاستعلامات عن الحالة.

السياق

يوفر فضاء الأسماء ara::nm في AUTOSAR Adaptive Platform الواجهات الأساسية لـ Network Management الوظيفية. تشكل الفئة NetworkHandle الواجهة الوظيفية الأساسية، والتي تغلف الوصول الخاضع للتحكم إلى كل من حالة الشبكة المطلوبة والفعلية. عبر آلية التجريد هذه، يمكن للتطبيقات الوظيفية وخدمات المنصة مراقبة حالة التشغيل الحالية لشبكة الاتصال الأساسية وبدء تغييرات الحالة.

لمعالجة أخطاء متسقة وقوية، يوفر ara::nm أنواعًا قياسية ودوال مساعدة مدمجة في معمارية أخطاء AUTOSAR Adaptive. يشمل ذلك نطاق الخطأ NmErrorDomain، وفئة الاستثناء NmException، بالإضافة إلى التعداد الخاص بالنطاق NmErrc [SWS_ANM_01111]. تتوفر بالإضافة إلى ذلك الدوال الآمنة لولبيًا GetNmDomain [SWS_ANM_01109] وMakeErrorCode [SWS_ANM_01110]، والتي تضمن التعامل المتوافق مع الاستنساخ والأنواع لحالات الخطأ.

diag_nm_kontext Anwendung Anwendung NetworkHandle NetworkHandle Anwendung->NetworkHandle يستخدم NmErrorDomain NmErrorDomain Anwendung->NmErrorDomain يفحص NmException NmException Anwendung->NmException يلتقط NetworkHandle->NmErrorDomain يشير إلى

مخطط السياق: التفاعل بين التطبيق وNetworkHandle ومعمارية الأخطاء في ara::nm. المصادر: [SWS_ANM_01109]، [SWS_ANM_01110]، [SWS_ANM_01111].

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

في سيناريو استخدام نموذجي، يتفاعل Adaptive Application مع فضاء الأسماء ara::nm للتحكم في حالة الشبكة والاستجابة لأحداث وقت التشغيل. ينقسم تسلسل التفاعل إلى الخطوات التالية:

  • بدء الوصول إلى الحالة: يستخدم التطبيق NetworkHandle للاستعلام عن حالة الشبكة المطلوبة أو الفعالة حاليًا.
  • اكتشاف الخطأ: إذا تعذر تلبية طلب الشبكة بشكل صحيح، تُشير الواجهة إلى حدث خطأ مطابق. تفسير: في حال حدوث أعطال في خدمات الشبكة الأساسية، يُرجح أن NetworkHandle ينشئ داخليًا رموز خطأ استنادًا إلى NmErrc. سؤال Q-97b1567be5e28121 (مفتوح)
  • إنشاء رمز الخطأ: تقبل الدالة المساعدة MakeErrorCode [SWS_ANM_01110] قيمة من NmErrc [SWS_ANM_01111] بالإضافة إلى بيانات إضافية خاصة بالتطبيق (ara::core::ErrorDomain::SupportDataType) وتنشئ منها ara::core::ErrorCode مكتمل الأركان. تم تحديد الدالة بأنها constexpr وnoexcept وتضمن أمانًا لولبيًا كاملاً [SWS_ANM_01110].
  • التحقق من نطاق الخطأ: يمكن للمكون المستدعي استرداد مرجع آمن لولبيًا إلى NmErrorDomain العام عبر GetNmDomain [SWS_ANM_01109]، وذلك للتحقق من نطاق الخطأ للرمز المُعاد وتحليل أوصاف الأخطاء الخاصة بالنطاق.
تسلسل التفاعل مع حالة الشبكة ومعالجة الأخطاءالتطبيقNetworkHandleNmErrorDomainNetzstatus anfordernaltالخدمة غير متوفرةMakeErrorCode(NmErrc::kServiceNotAvailable, ...)[SWS_ANM_01110]ara::core::ErrorCodeإرجاع رمز الخطأ [SWS_ANM_01111]GetNmDomain() للتحقق [SWS_ANM_01109]const ara::core::ErrorDomain&NormalbetriebEffektiven Netzstatus liefern

مخطط التسلسل: مسار الاستعلام عن حالة الشبكة وحل الأخطاء عبر ara::nm. المصادر: [SWS_ANM_01109]، [SWS_ANM_01110]، [SWS_ANM_01111].

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

يتم تجميع رموز الخطأ المعيارية للوحدة في التعداد NmErrc، والذي يستند إلى ara::core::ErrorDomain::CodeType [SWS_ANM_01111]. تميز الوحدة بين حالات الخطأ التالية:

  • NmErrc::kServiceNotAvailable (الرمز 1): يشير هذا الخطأ إلى أن الخدمة المطلوبة لإدارة الشبكة لا يمكن الوصول إليها أو أنها غير جاهزة للتشغيل في وقت التشغيل [SWS_ANM_01111]. في هذه الحالة، يجب على المستدعين الاستجابة بإعادة المحاولة أو استراتيجيات التراجع.
  • NmErrc::kInvalidHandler (الرمز 2): يحدث عند تمرير مُعالج غير صالح أو غير مسجل أو الإشارة إليه أثناء عملية ما [SWS_ANM_01111]. يشير هذا عادةً إلى خطأ في التكوين أو التهيئة في جهة المُستدعي.

تتمثل الشروط المسبقة للاستدعاءات القوية في بنية تحتية مُهيأة للخدمة بالإضافة إلى معلمات صالحة عند الوصول إلى NetworkHandle، لتجنب NmErrc::kServiceNotAvailable أو NmErrc::kInvalidHandler [SWS_ANM_01111]. جميع الدوال الأساسية لمعالجة الأخطاء مثل MakeErrorCode [SWS_ANM_01110] وGetNmDomain [SWS_ANM_01109] لا تُطلق استثناءات بحد ذاتها (noexcept). تفسير: بالنسبة للتطبيقات التي تفضل بنية تحكم قائمة على الاستثناءات، يُرجح أن فئة الاستثناء NmException تعمل كحامل لنشر حالات الخطأ بشكل منظم عبر مكدس الاستدعاءات (Callstack). سؤال Q-67a17c37021e8beb (مفتوح)

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

خريطة المواضيع

الفئات

3
NetworkHandleNmErrorDomainNmException

الدوال

2
GetNmDomainMakeErrorCode

الأنواع والثوابت

1
NmErrc

عرض التفاصيل

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

الفئات

NetworkHandle فئة

Zugang zu angefordertem und effektivem Netzstatus.

NmErrorDomain فئة

Fehlerdomäne für ara::nm.

NmException فئة

Exception-Typ für ara::nm.

الدوال

GetNmDomain دالة
constexpr const ara::core::ErrorDomain& GetNmDomain() noexcept;
MakeErrorCode دالة
constexpr ara::core::ErrorCode MakeErrorCode(NmErrc code, ara::core::ErrorDomain::SupportDataType data) noexcept;

الأنواع والثوابت

NmErrc تعداد
enum class NmErrc : ara::core::ErrorDomain::CodeType { kServiceNotAvailable = 1, kInvalidHandler = 2 };

التعدادات

تعداد NmErrc [SWS_ANM_01111]

enum class NmErrc : ara::core::ErrorDomain::CodeType { kServiceNotAvailable = 1, kInvalidHandler = 2 };
Headerara/nm/nm_error_domain.h
Upstream-AnforderungRS_AP_00122, RS_AP_00125, RS_AP_00127, RS_AP_00149

Standardisierte Network-Management-Fehlercodes.

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

يحدد التعداد [SWS_ANM_01111] رموز الأخطاء القياسية الخاصة بـ Network Management (NM) في ملف الرأس ara/nm/nm_error_domain.h. كما يتم توفيره عبر الاسم المستعار للنوع Errc [SWS_ANM_01103]، ويُستخدم مع دالة المصنع الآمنة لمؤشرات الترابط MakeErrorCode [SWS_ANM_01110] لتغليف حالات الخطأ في قيم الإرجاع ara::core::Result.

تتعامل قيم الأخطاء المحددة مع حالات خطأ معينة في واجهة NM:

  • kServiceNotAvailable (القيمة 1): يحدث أثناء عمليات الاستعلام والطلب المتزامنة لحالة الشبكة، عندما تكون خدمة NM الأساسية غير متاحة. ويشمل ذلك قراءة حالة الشبكة الفعلية عبر GetNetworkState [SWS_ANM_01007]، والاستعلام عن الحالة المطلوبة عبر GetNetworkRequestedState [SWS_ANM_01008]، بالإضافة إلى طلب الشبكات أو تحريرها عبر SetNetworkRequestedState [SWS_ANM_01009].
  • kInvalidHandler (القيمة 2): يتم الإبلاغ عنه بواسطة دوال التسجيل لمعالجات الإشعارات، وتحديدًا RegisterNetworkStateChangeNotifier [SWS_ANM_01010]، [SWS_ANM_01015] وRegisterNetworkRequestedStateChangeNotifier [SWS_ANM_01012]، [SWS_ANM_01014]. وبما أنه يُسمح بتسجيل إخطار واحد على الأكثر لكل واجهة، يُرجّح أن يحدث هذا الخطأ إذا تم تمرير رد نداء (callback) فارغ أو إذا كان التسجيل موجودًا بالفعل (تفسير). سؤال Q-59365b2b5b2e664c (مفتوح)

فيما يتعلق بالتزامن، تجدر الإشارة إلى أن عمليات القراءة الخالصة لحالة الشبكة آمنة بالنسبة لمؤشرات الترابط، في حين تم تحديد SetNetworkRequestedState وجميع عمليات تسجيل الإخطارات صراحةً على أنها غير آمنة بالنسبة لمؤشرات الترابط. لذلك، يجب على الجهات المستدعية إجراء مزامنة خارجية للوصول المتنافس إلى عمليات التسجيل وتغييرات الطلبات، لتجنب حالات الاستدعاء الخاطئة.

تم إنشاء هذا النص وتنسيقه بواسطة ذكاء اصطناعي.

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

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

Record
AUTOSAR/AP/record/SWS_ANM_01111
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_ANM_01111@rel:R25-11#43729f14
Content hash
43729f14
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_NetworkManagement.pdf#nameddest=SWS_ANM_01111
Status: valid/unmigrated Version: rel:R25-11#31e88722 Versionshistorie & Revisions (1 transition, 4 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_ANM_01111@rel:R25-11#31e88722
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#3bd1d10b2026-09-30
  • R23-11rel:R23-11#b1db0f132026-10-14
  • R24-11rel:R24-11#74d33b0b2026-10-14
  • R25-11rel:R25-11#31e887222026-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

توثيق الدوال الحرة

دالة GetNmDomain [SWS_ANM_01109]

constexpr const ara::core::ErrorDomain& GetNmDomain() noexcept;
Headerara/nm/nm_error_domain.h
Upstream-AnforderungRS_AP_00119, RS_AP_00120, RS_AP_00159
Thread Safetythread-safe
Rückgabeconst ara::core::ErrorDomain&

Gibt eine Referenz auf NmErrorDomain zurück.

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

Record
AUTOSAR/AP/record/SWS_ANM_01109
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_ANM_01109@rel:R25-11#a5a52234
Content hash
a5a52234
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_NetworkManagement.pdf#nameddest=SWS_ANM_01109
Status: valid/unmigrated Version: rel:R25-11#f3783a2f Versionshistorie & Revisions (1 transition, 4 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_ANM_01109@rel:R25-11#f3783a2f
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#43e9e8262026-09-30
  • R23-11rel:R23-11#0c322a072026-10-14
  • R24-11rel:R24-11#f3783a2f2026-10-14
  • R25-11rel:R25-11#f3783a2f2026-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

دالة MakeErrorCode [SWS_ANM_01110]

constexpr ara::core::ErrorCode MakeErrorCode(NmErrc code, ara::core::ErrorDomain::SupportDataType data) noexcept;
Headerara/nm/nm_error_domain.h
Upstream-AnforderungRS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00159, RS_AP_00135
Thread Safetythread-safe
Rückgabeara::core::ErrorCode

Erzeugt einen ara::core::ErrorCode für NmErrc.

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

الاستخدام

تُستخدم الدالة MakeErrorCode في الوحدة anm لإنشاء ara::core::ErrorCode قياسي لأخطاء Network Management [SWS_ANM_01110]. الدالة معرّفة في ملف الترويسة ara/nm/nm_error_domain.h وتغلف رمز الخطأ المحدد code من نوع التعداد NmErrc مع بيانات إضافية خاصة بالشركة المصنعة data من النوع ara::core::ErrorDomain::SupportDataType بشكل متزامن في كائن خطأ مطابق [SWS_ANM_01110]. يقوم المستدعون بتمرير حالة الخطأ المعنية بالإضافة إلى بيانات السياق للحصول على كائن خطأ موحد للمعالجة اللاحقة للأخطاء [SWS_ANM_01110].

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

نظراً لأن MakeErrorCode معلنة بالمحدد noexcept، فإن الدالة تضمن عدم إطلاق أي استثناءات أثناء تنفيذها [SWS_ANM_01110]. وفيما يتعلق بسلوك التزامن، تم تصنيف الدالة على أنها thread-safe؛ وبالتالي يمكن استدعاؤها بأمان من خيوط معالجة متوازية دون الحاجة إلى تدابير تزامن خارجية إضافية [SWS_ANM_01110]. وبفضل تأهيلها كـ constexpr، من المحتمل أن يتمكن المترجم من إجراء بناء كائن الخطأ بالكامل في وقت الترجمة عند تمرير معاملات ثابتة [SWS_ANM_01110]. سؤال Q-a04f5f6a2218370e (مفتوح)

تفاعل

بصفتها دالة إنشاء مركزية لرموز أخطاء Network Management، تربط MakeErrorCode الوحدة بالمفهوم العام لمعالجة الأخطاء في منصة AUTOSAR Adaptive [SWS_ANM_01110]. وهي تلبي مباشرة المتطلبات العليا الأولية (upstream requirements) وهي RS_AP_00119 وRS_AP_00120 وRS_AP_00121 وRS_AP_00159 بالإضافة إلى RS_AP_00135 [SWS_ANM_01110].

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

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

Record
AUTOSAR/AP/record/SWS_ANM_01110
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_ANM_01110@rel:R25-11#146dc66c
Content hash
146dc66c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_NetworkManagement.pdf#nameddest=SWS_ANM_01110
Status: valid/unmigrated Version: rel:R25-11#2b6b1c06 Versionshistorie & Revisions (1 transition, 4 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_ANM_01110@rel:R25-11#2b6b1c06
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#428b741c2026-09-30
  • R23-11rel:R23-11#1edc012e2026-10-14
  • R24-11rel:R24-11#2b6b1c062026-10-14
  • R25-11rel:R25-11#2b6b1c062026-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