DEENESPTFRRUARHIKOZHNL

فئة ara::tsync::ConsumerTimeBaseValidationNotification

[SWS_TS_00428] Upstream: RS_TS_00034 لم يُستورد النص بعد, RS_TS_00030 لم يُستورد النص بعد

class ConsumerTimeBaseValidationNotification {...};

Callback interface to notify Consumer Application about the availability of a new data block recorded for the Time Base. .

Header-Datei#include "ara/tsync/consumer_time_base_validation_notification.h"
Forwarding-Header#include "ara/tsync/tsync_fwd.h"
Scopenamespace ara::tsync

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

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

يُخطر تطبيقات المستهلك (Consumer) بكتل بيانات القياس المتاحة حديثًا للتحقق من صحة قاعدة زمنية.

تُخطر الواجهة ara::tsync::ConsumerTimeBaseValidationNotification تطبيقات المستهلك بكتل بيانات القياس المتاحة حديثًا لقاعدة زمنية. وعبر طرق رد النداء (Callback) SetSlaveTimingData [SWS_TS_00420] وSetPdelayInitiatorData [SWS_TS_00422]، يمرر النظام بيانات التوقيت والتحقق المفصلة لكل من Time Slave وبادئ pDelay. يقوم مطورو التطبيقات بالاشتقاق من الفئة، وتنفيذ معالجة البيانات، ويجب عليهم التأكد من عدم إطلاق أي استثناءات، نظرًا لأن جميع الطرق محددة كـ noexcept وآمنة من الاستثناءات. بالإضافة إلى ذلك، يتطلب التصنيف كـ non_threadsafe مزامنة من جانب التطبيق عند عمليات الوصول المتزامنة.

السياق

تمثل الفئة ara::tsync::ConsumerTimeBaseValidationNotification واجهة رد نداء (Callback) في الوحدة tsync لـ AUTOSAR Adaptive Platform. ويكمن الغرض منها في إخطار تطبيق مستهلك بمجرد توفر كتل بيانات مسجلة جديدة لقاعدة زمنية خاضعة للمراقبة.

تشارك في هذا التفاعل ثلاث مكونات بشكل أساسي:

  • قاعدة زمنية للوحدة tsync: تسجل باستمرار قياسات الوقت والمزامنة في شبكة الاتصال.
  • الواجهة ConsumerTimeBaseValidationNotification: تحدد نقاط التسليم لكتل بيانات القياس المسجلة عبر الطرق SetSlaveTimingData [SWS_TS_00420] وSetPdelayInitiatorData [SWS_TS_00422].
  • تطبيق المستهلك: ينفذ طرق رد النداء، ويستلم قيم القياس المقدمة، ويجري التحقق الوظيفي من صحة القاعدة الزمنية.

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

دورة الحياة

باعتبارها فئة واجهة مجردة تحتوي على طرق افتراضية بحتة (pure virtual)، لا يمكن إنشاء مثيل لـ ara::tsync::ConsumerTimeBaseValidationNotification مباشرةً. يقوم تطبيق المستهلك باشتقاق فئة ملموسة وتنفيذ الطرق المطلوبة.

تقع مسؤولية الإنشاء والملكية بالكامل على عاتق تطبيق المستهلك. يُفترض أن ينشئ التطبيق كائن رد النداء أثناء مرحلة التهيئة الخاصة به ويربطه بالقاعدة الزمنية المقابلة لخدمة tsync. سؤال Q-a423ce4cbd4eeaaa (مفتوح)

لأغراض التدمير، توفر الفئة مُدمِّرًا افتراضيًا: virtual ~ConsumerTimeBaseValidationNotification() noexcept = default; [SWS_TS_01300]. يضمن التصريح عنه كمُدمِّر افتراضي إمكانية تحرير مثيلات الفئات المشتقة عبر مؤشرات الفئة الأساسية بأمان من حيث النوع ودون حدوث تسريب في الموارد.

فيما يتعلق بالتزامن، حُددت طرق الإخطار SetSlaveTimingData [SWS_TS_00420] وSetPdelayInitiatorData [SWS_TS_00422] بأنها non_threadsafe. إذا كان الاستدعاء من قِبل خدمة المنصة مرجحًا أن يتم في سياق مؤشر ترابط خلفي (Background Thread)، فإن التنفيذ من جانب التطبيق مسؤول بنفسه عن تأمين عمليات الوصول إلى موارد التطبيق المشتركة. سؤال Q-1b857df043504eec (مفتوح)

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

يتضمن التسلسل النموذجي لاستخدام إخطار التحقق من الصحة الخطوات التالية:

  1. التنفيذ: ينفذ تطبيق المستهلك فئة مشتقة من ara::tsync::ConsumerTimeBaseValidationNotification.
  2. استلام بيانات قياس Time Slave: بمجرد تسجيل كتلة بيانات قياس جديدة لـ Time Slave الخاص بالقاعدة الزمنية، تستدعي خدمة الوقت الطريقة SetSlaveTimingData [SWS_TS_00420] وتمرر بيانات التحقق المفصلة عبر المعلمة measurementData من النوع TimeSlaveMeasurementType.
  3. استلام بيانات قياس بادئ pDelay: في حال توفر بيانات قياس جديدة لبادئ pDelay، يتم استدعاء SetPdelayInitiatorData [SWS_TS_00422] مع بيانات التوقيت المفصلة في PdelayInitiatorMeasurementType.
  4. المعالجة: يقيّم تطبيق المستهلك كتل البيانات المنقولة لاكتشاف أخطاء المزامنة أو انحرافات زمن التشغيل.
  5. تحرير الكائن: عند إنهاء المراقبة، يتم تفكيك المثيل عبر المُدمِّر الافتراضي [SWS_TS_01300].
تسلسل الإشعار بشأن بيانات التحققZeitbasis (tsync)ValidationNotificationConsumer-AnwendungSetSlaveTimingData(measurementData)Time-Slave-Messdaten verarbeitenSetPdelayInitiatorData(measurementData)pDelay-Initiator-Messdaten verarbeiten

مخطط تسلسلي: نقل كتل بيانات القياس المسجلة لـ Time Slave وبادئ pDelay إلى تنفيذ المستهلك. المصادر: [SWS_TS_00420]، [SWS_TS_00422].

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

صُممت طرق الواجهة لتحقيق أقصى درجات المتانة والاستدعاءات الحتمية:

  • أمان الاستثناءات: صُرح عن كافة الدوال الأعضاء – SetSlaveTimingData [SWS_TS_00420]، SetPdelayInitiatorData [SWS_TS_00422] والمُدمِّر [SWS_TS_01300] – باستخدام noexcept وحُددت بأنها آمنة من الاستثناءات (exception safe). لا يجوز للطرق التي تعيد التعريف في تطبيق المستهلك تمرير أي استثناءات إلى الخارج، لأن ذلك يؤدي إلى إنهاء البرنامج فورًا.
  • غياب قنوات الإفادة الراجعة: نظرًا لأن طرق رد النداء تمتلك نوع الإرجاع void، فلا يمكن إرجاع أخطاء المعالجة ضمن منطق التطبيق إلى الوحدة tsync. يجب على التطبيق معالجة أي حالات خطأ داخليًا وتسجيلها بشكل مستقل.
  • مخاطر التزامن: بناءً على الخاصية non_threadsafe ([SWS_TS_00420]، [SWS_TS_00422])، يجب منع معالجة كتل بيانات متعددة بالتوازي دون إقفال من جانب التطبيق. تفسير: يجب أن يظل كائن رد النداء صالحًا طوال فترة التسجيل في القاعدة الزمنية لمنع عمليات الوصول الكارثية إلى ذاكرة تم تحريرها بالفعل. سؤال Q-934e451f6a0099c1 (مفتوح)

يستند هذا الدليل إلى مواصفة AUTOSAR Adaptive R25-11 للوحدة tsync. وتُمثل الإيضاحات التي لا تستند إلى أدلة صريحة من المواصفة تفسيرات فنية.

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

المُنشئات والمُتلف

1
~ConsumerTimeBaseValidationNotification

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

2
SetPdelayInitiatorDataSetSlaveTimingData

مخطط الفئة

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

G nara__tsync__ConsumerTimeBaseValidationNotification118 ConsumerTimeBaseValidationNotification + ~ConsumerTimeBaseValidationNotification() + SetPdelayInitiatorData() + SetSlaveTimingData()

عرض التفاصيل

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

المُنشئات والمُتلف

~ConsumerTimeBaseValidationNotification دالة

Destructor .

virtual ~ConsumerTimeBaseValidationNotification () noexcept=default;

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

SetPdelayInitiatorData دالة

Provide the recorded data block for the pPelay Initiator of the Time Base.

virtual void SetPdelayInitiatorData (const PdelayInitiatorMeasurement Type &measurementData) noexcept=0;
SetSlaveTimingData دالة

Provide the recorded data block for the Time Slave of the Time Base.

virtual void SetSlaveTimingData (const TimeSlaveMeasurementType &measurementData) noexcept=0;

توثيق الدوال

دالة SetPdelayInitiatorData [SWS_TS_00422] Upstream: RS_TS_00034 لم يُستورد النص بعد, RS_TS_00030 لم يُستورد النص بعد

virtual void SetPdelayInitiatorData (const PdelayInitiatorMeasurement Type &measurementData) noexcept=0;

Provide the recorded data block for the pPelay Initiator of the Time Base.

Header-Datei#include "ara/tsync/consumer_time_base_validation_notification.h"
Scopeclass ara::tsync::ConsumerTimeBaseValidationNotification
Exception-Sicherheitexception safe
Thread-Sicherheitnon_threadsafe

Parameter (in)

ParameterBeschreibung
measurementDataDetailed timing data for the pDelay Initiator

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_TS_00422
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_00422@rel:R25-11#059c4fee
Content hash
059c4fee
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_00422
Status: valid/unmigrated Version: rel:R25-11#30c61c3d Versionshistorie & Revisions (1 transition, 8 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_00422@rel:R25-11#30c61c3d
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#bc80faac2026-09-30
  • R19-11rel:R19-11#eb03dca32026-10-14
  • R20-11rel:R20-11#bc341be62026-10-14
  • R21-11rel:R21-11#bc341be62026-10-14
  • R22-11rel:R22-11#9da969872026-10-14
  • R23-11rel:R23-11#dcb016da2026-10-14
  • R24-11rel:R24-11#30c61c3d2026-10-14
  • R25-11rel:R25-11#30c61c3d2026-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

دالة SetSlaveTimingData [SWS_TS_00420] Upstream: RS_TS_00034 لم يُستورد النص بعد, RS_TS_00030 لم يُستورد النص بعد

virtual void SetSlaveTimingData (const TimeSlaveMeasurementType &measurementData) noexcept=0;

Provide the recorded data block for the Time Slave of the Time Base.

Header-Datei#include "ara/tsync/consumer_time_base_validation_notification.h"
Scopeclass ara::tsync::ConsumerTimeBaseValidationNotification
Exception-Sicherheitexception safe
Thread-Sicherheitnon_threadsafe

Parameter (in)

ParameterBeschreibung
measurementDataDetailed data for validation of the Time Slave

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_TS_00420
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_00420@rel:R25-11#69ca8a95
Content hash
69ca8a95
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_00420
Status: valid/unmigrated Version: rel:R25-11#db5c7e95 Versionshistorie & Revisions (1 transition, 8 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_00420@rel:R25-11#db5c7e95
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#0ae186d02026-09-30
  • R19-11rel:R19-11#9045509e2026-10-14
  • R20-11rel:R20-11#d0bb9b042026-10-14
  • R21-11rel:R21-11#d0bb9b042026-10-14
  • R22-11rel:R22-11#80e6946d2026-10-14
  • R23-11rel:R23-11#b85a4f422026-10-14
  • R24-11rel:R24-11#db5c7e952026-10-14
  • R25-11rel:R25-11#db5c7e952026-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

دالة ~ConsumerTimeBaseValidationNotification [SWS_TS_01300] Upstream: RS_TS_00034 لم يُستورد النص بعد, RS_TS_00030 لم يُستورد النص بعد

virtual ~ConsumerTimeBaseValidationNotification () noexcept=default;

Destructor .

Header-Datei#include "ara/tsync/consumer_time_base_validation_notification.h"
Scopeclass ara::tsync::ConsumerTimeBaseValidationNotification
Exception-Sicherheitexception safe

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

Record
AUTOSAR/AP/record/SWS_TS_01300
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01300@rel:R25-11#f84a4abc
Content hash
f84a4abc
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01300
Status: valid/unmigrated Version: rel:R25-11#dffdb922 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_TS_01300@rel:R25-11#dffdb922
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#786258362026-09-30
  • R23-11rel:R23-11#8b1738b12026-10-14
  • R24-11rel:R24-11#3389479d2026-10-14
  • R25-11rel:R25-11#dffdb9222026-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