DEENESPTFRRUARHIKOZHNL

نطاق أسماء apext::tsync

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

يوفر واجهات وحاويات لإدارة Freshness Value Management لتأمين تزامن الوقت.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 81e51095e95c المصدر أسئلة مفتوحة (3)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يوفر واجهات وحاويات لإدارة Freshness Value Management لتأمين تزامن الوقت.

يوفر نطاق الأسماء apext::tsync واجهات وحاويات بيانات لـ Freshness Value Management لتزامن الوقت في Adaptive. عبر الواجهة FVM، يتم تغليف قيم الحداثة في مثيلات FVContainer لحماية رسائل الوقت من هجمات إعادة التشغيل. وإذا حدث خطأ غير قابل للإصلاح أثناء التهيئة أو كانت القيمة غير متاحة مؤقتًا، فيتم تمثيل ذلك عبر رموز أخطاء TsyncFvmErrorDomain [SWS_TS_14202]. ويتم إنشاء مثيلات كائنات الأخطاء القياسية بأمان من حيث الاستثناءات وأمان الخيوط (threadsicher) عبر MakeErrorCode [SWS_TS_14213].

السياق

يمثل نطاق الأسماء apext::tsync امتدادًا خاصًا بالمنصة لتزامن وقت AUTOSAR Adaptive (ara::tsync). ومهمته المركزية هي Freshness Value Management (FVM)، والتي توفر آليات لضمان حداثة معلومات الوقت لمنع هجمات إعادة التشغيل والحالات المتقادمة في الشبكات المتزامنة زمنيًا. وتشمل المكونات الأساسية الواجهة FVM، وحاوية البيانات FVContainer، ومجال الخطأ TsyncFvmErrorDomain، بالإضافة إلى فئة الاستثناء TsyncFvmException.

تُغلّف الفئة FVContainer قيمة حداثة من خلال إدارة طولها بالبتات بالإضافة إلى القيمة نفسها في شكل متجه بايتات. وتعمل الواجهة FVM كجسر وظيفي لـ ara::tsync. ويُرجح أن تعمل FVM كواجهة تجريد تحصل من خلالها مثيلات مزامنة الوقت لـ ara::tsync على قيم الحداثة الحالية أو تتحقق منها. سؤال Q-f92f53d92ec347e5 (مفتوح) ويضمن مجال الخطأ TsyncFvmErrorDomain والدوال المساعدة المرتبطة به الإبلاغ الموحد عن الأخطاء [SWS_TS_14212].

ara_tsync ara::tsync FVM apext::tsync::FVM ara_tsync->FVM يستخدم FVContainer apext::tsync::FVContainer FVM->FVContainer يُنشئ / يملأ TsyncFvmErrorDomain apext::tsync::TsyncFvmErrorDomain FVM->TsyncFvmErrorDomain referenziert

مخطط السياق: مكونات نطاق الأسماء apext::tsync وتفاعلها مع ara::tsync. المصادر: [SWS_TS_14202]، [SWS_TS_14212].

دورة الحياة

تنقسم دورة حياة المكونات في نطاق الأسماء apext::tsync إلى مراحل التهيئة والتشغيل والإنهاء. بالنسبة لمرحلة التهيئة، يُعرّف التعداد TsyncFvmErrc قيمة الخطأ kFVInitializeFailed (= 2)، والمحددة على أنها خطأ غير قابل للإصلاح (unrecoverable error) وتشير إلى تعذر استخدام Freshness Value Manager [SWS_TS_14202]. يُشير الخطأ kFVInitializeFailed على الأرجح إلى ضرورة اجتياز مرحلة تهيئة لـ FVM قبل استرداد Freshness Values، حيث يؤدي فشلها إلى استبعاد أي استخدام لاحق. سؤال Q-d9c097d736bae053 (مفتوح)

أثناء التشغيل، تتمتع مثيلات FVContainer بعمر افتراضي مؤقت: يتم إنشاء مثيل لها عند الحاجة، وملؤها بالمتجه وطول البتات، وتمريرها إلى مثيلات بروتوكول المزامنة. وفي المقابل، يمتلك كائن مجال الخطأ TsyncFvmErrorDomain عمرًا افتراضيًا ثابتًا على مدار مدة العملية بأكملها. تُرجع الدالة GetTsyncFvmErrorDomain() مرجعًا إلى كائن المثيل العام [SWS_TS_14212]. تم الإعلان عن كل من GetTsyncFvmErrorDomain() ودالة المصنع MakeErrorCode() كـ constexpr وnoexcept وتحديدهما على أنهما آمنان من الاستثناءات ومن الخيوط (threadsicher) [SWS_TS_14212]، [SWS_TS_14213]. يتيح ذلك إنشاء الأخطاء والاستعلام عنها بشكل متزامن دون أقفال مزامنة.

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

يشمل مسار الاستخدام النموذجي بالتفاعل مع تزامن الوقت توفير قيم الحداثة وتقييمها:

  1. يطلب مكون من ara::tsync قيمة حداثة حالية عبر الواجهة FVM لتأمين رسالة وقت.
  2. عند تحديد القيمة بنجاح، يُنشئ FVM أو يملأ مثيلًا من FVContainer بطول البتات ومتجه البايتات للقيمة ويُعيده إلى المتصل.
  3. إذا تعذر توفير قيمة الحداثة مؤقتًا في وقت التشغيل، يُبلغ FVM عن الخطأ القابل للإصلاح kFVNotAvailable [SWS_TS_14202]. ولهذا الغرض، يتم إنشاء كائن ara::core::ErrorCode مناسب مع بيانات إضافية خاصة بالشركة المصنعة عبر MakeErrorCode() [SWS_TS_14213].
  4. يقوم المكون المستدعي بتقييم النتيجة واتخاذ القرار بشأن محاولات إعادة التجربة أو التدابير البديلة.
استرجاع قيمة الحداثة عبر FVMara::tsyncapext::tsync::FVMapext::tsync::FVContainerطلب قيمة الحداثةaltالقيمة متاحةملء المثيل بطول البتات والمتجهتمرير FVContainerkFVNotAvailableMakeErrorCode(kFVNotAvailable)إرجاع إشعار ara::core::ErrorCode

مخطط التسلسل: استرداد قيمة الحداثة ومعالجة حالات الخطأ المحتملة. المصادر: [SWS_TS_14202]، [SWS_TS_14213].

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

تستند معالجة الأخطاء في apext::tsync إلى بنية ara::core::ErrorDomain وara::core::ErrorCode. رموز أخطاء TsyncFvmErrorDomain مدرجة في التعداد TsyncFvmErrc، ونوعه الأساسي هو ara::core::ErrorDomain::CodeType [SWS_TS_14202]:

  • kFVNotAvailable (= 1): خطأ قابل للإصلاح (recoverable error)، يُشير إلى أن Freshness Value غير متاح حاليًا [SWS_TS_14202]. يمكن للمستدعين إعادة إرسال الطلب أو تخطي دورة المعالجة الحالية.
  • kFVInitializeFailed (= 2): خطأ غير قابل للإصلاح (unrecoverable error)، يُفيد بتعذر تهيئة Freshness Value Manager أو استخدامه [SWS_TS_14202]. يؤدي هذا إلى إيقاف خدمات تزامن الوقت التابعة.

يتم إنشاء كائنات الأخطاء الملموسة عبر الدالة المساعدة MakeErrorCode(TsyncFvmErrc code, ara::core::ErrorDomain::SupportDataType data)، والتي تقبل المعدد والبيانات الإضافية الخاصة بالشركة المصنعة [SWS_TS_14213]. توجد الإعلانات في ملف الترويسة apext/tsync/fvm_error_domain.h، بينما يمكن الحصول على الإعلانات المسبقة عبر apext/tsync/tsync_fwd.h [SWS_TS_14202]. ولمسارات الأخطاء القائمة على الاستثناءات، يوفر نطاق الأسماء الفئة TsyncFvmException. يُرجح طرح TsyncFvmException إذا تم الإبلاغ عن أخطاء TsyncFvmErrorDomain في سياقات الاستثناءات بدلًا من الإبلاغ عنها عبر ara::core::ErrorCode. سؤال Q-a779e133b471f03d (مفتوح)

يستند هذا الدليل إلى مواصفات AUTOSAR R25-11 لنطاق الأسماء apext::tsync وتم إنشاؤه آليًا.

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

مخطط الفئة

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::tsync napext__tsync__FVContainer «struct» FVContainer napext__tsync__FVM FVM napext__tsync__TsyncFvmErrorDomain TsyncFvmErrorDomain next_ara__core__ErrorDomain ara::core::ErrorDomain napext__tsync__TsyncFvmErrorDomain->next_ara__core__ErrorDomain napext__tsync__TsyncFvmException TsyncFvmException next_ara__core__Exception ara::core::Exception napext__tsync__TsyncFvmException->next_ara__core__Exception

عرض التفاصيل

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

الفئات

A freshness value container to hold the length of freshness value in bits and the freshness value itself as vector.

FVM فئة

A freshness value management interface for ara::tsync.

Defines a class representing the Freshness Value Manager error domain.

يرث من ara::core::ErrorDomain

Defines a class for exceptions to be thrown by the Freshness Value Manager.

يرث من ara::core::Exception

الدوال

Returns a reference to the global apext::tsync::TsyncFvmErrorDomain object.

constexpr const ara::core::ErrorDomain & GetTsyncFvmErrorDomain () noexcept;
MakeErrorCode دالة

Creates an instance of ara::core::ErrorCode.

constexpr ara::core::ErrorCode MakeErrorCode (TsyncFvmErrc code, ara::core::ErrorDomain::SupportDataType data) noexcept;

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

TsyncFvmErrc تعداد

The enumeration class defines the error codes for the apext::tsync:: TsyncFvmErrorDomain.

enum class TsyncFvmErrc : ara::core::ErrorDomain::CodeType {...};

التعدادات

تعداد TsyncFvmErrc [SWS_TS_14202] Upstream: RS_TS_20072 لم يُستورد النص بعد

enum class TsyncFvmErrc :            ara::core::ErrorDomain::CodeType {...};

The enumeration class defines the error codes for the apext::tsync:: TsyncFvmErrorDomain.

Header-Datei#include "apext/tsync/fvm_error_domain.h"
Forwarding-Header#include "apext/tsync/tsync_fwd.h"
Scopenamespace apext::tsync
SymbolTsyncFvmErrc
Basistypara::core::ErrorDomain::CodeType

Werte

EnumeratorBeschreibung
kFVNotAvailable=1 Recoverable Error meaning the Freshness Value is not available.
kFVInitializeFailed=2 Unrecoverable Error meaning the Freshness Value Manager could not be used.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: cad092cfe90e المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام ودلالات الأخطاء

يحدّد التعداد TsyncFvmErrc وفقًا لـ [SWS_TS_14202] رموز الأخطاء المحددة لنطاق الأخطاء apext::tsync::TsyncFvmErrorDomain. وضمن النطاق، يُوفَّر التعداد أيضًا عبر الاسم المستعار للنوع apext::tsync::TsyncFvmErrorDomain::Errc [SWS_TS_14206]. يميّز التعداد بين حالتي خطأ رئيسيتين لـ Freshness Value Manager (FVM):

  • kFVNotAvailable (= 1): يميّز خطأً قابلًا للإصلاح (Recoverable Error) عند عدم توفر قيمة حداثة مطلوبة [SWS_TS_14202]. يظهر رمز الخطأ هذا بشكل خاص عند الاستعلام عن قيم حداثة الإرسال عبر apext::tsync::FVM::GetTxFreshness [SWS_TS_14199].
  • kFVInitializeFailed (= 2): يشير إلى خطأ غير قابل للإصلاح (Unrecoverable Error) عندما لا يكون Freshness Value Manager جاهزًا للتشغيل ويفشل [SWS_TS_14202]. يتم الإبلاغ عنه بواسطة apext::tsync::FVM::Initialize عند فشل التهيئة [SWS_TS_14200].

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

لمعالجة الأخطاء، يتم تحويل مُعدِّد (Enumerator) مع بيانات إضافية خاصة بالشركة المصنعة إلى كائن ara::core::ErrorCode عبر الدالة المساعدة apext::tsync::MakeErrorCode [SWS_TS_14213]. تُغلِّف دوال FVM مثل Initialize [SWS_TS_14200] وGetTxFreshness [SWS_TS_14199] وGetRxFreshness [SWS_TS_14198] النتيجة أو حالات الخطأ في ara::core::Result. تقوم مكونات التطبيق ومكونات TimeSync بتقييم كائن Result للتمييز بين حالات فشل قيم الحداثة الفردية القابلة للإصلاح وأخطاء التهيئة الجسيمة لـ FVM.

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

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

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

Record
AUTOSAR/AP/record/SWS_TS_14202
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_14202@rel:R25-11#635c6a05
Content hash
635c6a05
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_14202
Status: valid/unmigrated Version: rel:R25-11#b5e36b38 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_TS_14202@rel:R25-11#b5e36b38
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#e69ca41d2026-09-30
  • R24-11rel:R24-11#5774fd892026-10-14
  • R25-11rel:R25-11#b5e36b382026-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

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

دالة GetTsyncFvmErrorDomain [SWS_TS_14212] Upstream: RS_TS_20072 لم يُستورد النص بعد

constexpr const ara::core::ErrorDomain & GetTsyncFvmErrorDomain () noexcept;

Returns a reference to the global apext::tsync::TsyncFvmErrorDomain object.

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

توفّر الدالة GetTsyncFvmErrorDomain في مساحة الاسم apext::tsync مرجعًا إلى كائن نطاق الأخطاء العام apext::tsync::TsyncFvmErrorDomain [SWS_TS_14212]. للاستخدام، يجب تضمين ملف الرأس apext/tsync/fvm_error_domain.h [SWS_TS_14212].

الاستخدام

يتم الاستدعاء بشكل متزامن وبدون معلمات إدخال. كقيمة إرجاع، تُرجع الدالة مرجعًا ثابتًا من النوع const ara::core::ErrorDomain& إلى مثيل نطاق الأخطاء [SWS_TS_14212]. بفضل التصريح عنها كـ constexpr، يمكن أن يتم الوصول إلى الكائن العام بالفعل في وقت التصريف (Compile time) [SWS_TS_14212].

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

الدالة مصرح عنها كـ noexcept ومحددة بأنها آمنة من الاستثناءات (exception safe) [SWS_TS_14212]. ونظرًا لأنها تُرجع مرجعًا موجودًا فقط، فإنها لا تطلق أي استثناءات ولا تنشئ رموز خطأ.

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

الواجهة معرّفة بأنها آمنة لمؤشرات الترابط (thread-safe) [SWS_TS_14212]. ويمكن استدعاؤها بالتزامن من عدة مؤشرات ترابط دون آليات مزامنة إضافية. ولا توجد شروط ترتيب مقيدة للاستدعاء.

تفاعل

تفسير: يُرجّح أن كائن نطاق الأخطاء المشار إليه يعمل على تحديد أخطاء Freshness Value Management (FVM) الخاصة بالوحدة ومطابقتها بشكل فريد ضمن نموذج معالجة أخطاء AUTOSAR Adaptive عبر ara::core::ErrorCode. سؤال Q-2d0a2b5481f500bd (مفتوح)

تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي بالاستناد إلى المواصفة SWS_TS_14212.

Header-Datei#include "apext/tsync/fvm_error_domain.h"
Scopenamespace apext::tsync
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
const ara::core::ErrorDomain &A reference to the global apext::tsync:: TsyncFvmErrorDomain object.

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

Record
AUTOSAR/AP/record/SWS_TS_14212
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_14212@rel:R25-11#616ed2ec
Content hash
616ed2ec
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_14212
Status: valid/unmigrated Version: rel:R25-11#fd40d130 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_TS_14212@rel:R25-11#fd40d130
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#a77cf1b62026-09-30
  • R24-11rel:R24-11#2b0ce1082026-10-14
  • R25-11rel:R25-11#fd40d1302026-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_TS_14213] Upstream: RS_TS_20072 لم يُستورد النص بعد

constexpr ara::core::ErrorCode MakeErrorCode (TsyncFvmErrc code, ara::core::ErrorDomain::SupportDataType data) noexcept;

Creates an instance of ara::core::ErrorCode.

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

تُستخدم الدالة MakeErrorCode للإنشاء المتزامن لكائن ara::core::ErrorCode لحالات خطأ مجال أخطاء FVM في مساحة الأسماء apext::tsync [SWS_TS_14213]. وقد تم الإعلان عنها في ملف الرأس apext/tsync/fvm_error_domain.h [SWS_TS_14213]. وتستقبل كمعلمة رمز خطأ code من النوع TsyncFvmErrc بالإضافة إلى بيانات مصاحبة خاصة بالشركة المصنعة data من النوع ara::core::ErrorDomain::SupportDataType، وتُرجع كائن ara::core::ErrorCode مهيأً تبعًا لذلك [SWS_TS_14213].

فيما يتعلق بأمان التنفيذ، تم تعريف الدالة كـ noexcept وآمنة ضد الاستثناءات («exception safe»)، مما يضمن ألا تؤدي الاستدعاءات إلى إطلاق استثناءات C++‎ [SWS_TS_14213]. بالإضافة إلى ذلك، تم تحديدها على أنها آمنة لخيوط المعالجة («thread-safe») ويمكن تنفيذها بالتزامن دون مزامنة خارجية [SWS_TS_14213]. ونظرًا لتوقيع constexpr، يُرجح افتراض إمكانية تقييم الدالة أيضًا في تعبيرات وقت الترجمة، إذا كانت المعاملات ثابتة في وقت الترجمة [SWS_TS_14213]. سؤال Q-dbd77b45638ef338 (مفتوح)

في سياق الوحدة، تشكل الدالة النظير لـ MakeErrorCode من مساحة الأسماء القياسية ara::tsync [SWS_TS_00910]. وبينما تستخدم الدالة القياسية ara::tsync::TsyncErrc عبر ملف الرأس ara/tsync/tsync_error_domain.h [SWS_TS_00910]، يتيح هذا المتغير التغليف المحدد لأخطاء TsyncFvmErrc لوظائف مزامنة الوقت المتقدمة [SWS_TS_14213].

تم إنشاء ملاحظة الاستخدام هذه بشكل آلي استناداً إلى بيانات المواصفات.

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

Header-Datei#include "apext/tsync/fvm_error_domain.h"
Scopenamespace apext::tsync
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
codeThe error to throw.
dataVendor defined data associated with the error.

Rückgabewert

TypBeschreibung
ara::core::ErrorCodeAn ara::core::ErrorCode object.

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

Record
AUTOSAR/AP/record/SWS_TS_14213
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_14213@rel:R25-11#7a41a604
Content hash
7a41a604
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_14213
Status: valid/unmigrated Version: rel:R25-11#791565c2 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_TS_14213@rel:R25-11#791565c2
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#544bf7aa2026-09-30
  • R24-11rel:R24-11#c95efae82026-10-14
  • R25-11rel:R25-11#791565c22026-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