DEENESPTFRRUARHIKOZHNL

بنية apext::tsync::FVContainer

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

struct FVContainer {...};

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

Header-Datei#include "apext/tsync/fvm.h"
Forwarding-Header#include "apext/tsync/tsync_fwd.h"
Scopenamespace apext::tsync

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

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

تغليف قيم الحداثة كمتجه بايتات مع طولها الدقيق بالبتات لإدارة قيم الحداثة (Freshness Value Management).

يُستخدم الهيكل apext::tsync::FVContainer في الوحدة tsync كحاوية بيانات لتمرير وإرجاع قيم الحداثة بين التطبيقات وإدارة قيم الحداثة (Freshness Value Management). وهو يغلّف قيمة الحداثة الفعلية كمتجه بايتات في value، والذي يحتوي وفقًا للاتجاه على قيم كاملة أو مقتطعة [SWS_TS_14196]، بالإضافة إلى طوله الدقيق بالبتات في الخاصية length [SWS_TS_14195]. ويتطلب الوصول المتزامن تنسيقًا خارجيًا بواسطة المتصل.

السياق

يعمل الهيكل apext::tsync::FVContainer داخل المجموعة الوظيفية tsync لـ AUTOSAR Adaptive Platform كحاوية بيانات مخصصة لقيم الحداثة (Freshness Values). وعند تضمينه عبر ملف الترويسة apext/tsync/fvm.h، فإنه يُستخدم كواجهة قياسية في التفاعل مع إدارة قيم الحداثة (FVM). وتتمثل مسؤوليته الأساسية في توفير قيمة الحداثة التشفيرية الفعلية مع طولها الدقيق. ولهذا الغرض، تغلّف الحاوية الطول بالبتات في عنصر البيانات length [SWS_TS_14195] والبيانات المفيدة الفعلية في متجه البايتات value [SWS_TS_14196]. وبذلك يعمل الهيكل كجسر بين التطبيقات المتصلة أو طبقات البروتوكول وإجراءات حساب FVM.

دورة الحياة

كهيكل بيانات خفيف الوزن (struct)، يخضع apext::tsync::FVContainer لدلالات القيمة العادية في C++. وعادةً ما يتم إنشاؤه محليًا على مكدس المتصل أو ديناميكيًا في إطار إنشاء رسالة ذات مستوى أعلى. ومع إنشاء النسخة، يتحمل الهيكل مسؤولية دورة حياة المتجه المضمّن value من النوع ara::core::Vector<std::uint8_t> [SWS_TS_14196]. وإذا تم تمرير الهيكل عند إرساله إلى الواجهات بالقيمة أو بالإشارة، فإن مبدأ RAII للمتجه يضمن تحريرًا حتميًا للذاكرة المخصصة عند تدمير الحاوية. سؤال Q-416ceca84f9cfdaf (مفتوح) ونظرًا لأن apext::tsync::FVContainer لا يوفر آليات داخلية للمزامنة، فإن التنسيق الآمن خيطيًا للوصول المتزامن للقراءة والكتابة يقع بالكامل على عاتق مكون البرمجيات المتصل.

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

في الاستخدام العملي، يمر apext::tsync::FVContainer باتجاهين رئيسيين داخل اتصال الواجهات:

  • معامل إدخال: عند التحقق من الرسائل الواردة أو معالجتها، يتم ملء الحاوية بواسطة التطبيق وتمريرها إلى دوال FVM. واعتمادًا على السياق، يستقبل الحقل value إما قيم حداثة كاملة أو قيمًا مقتطعة (Truncated Values) [SWS_TS_14196]. وبالتوازي مع ذلك، يحدد الحقل length عدد البتات الدقيق للقيمة المضمّنة [SWS_TS_14195]. ويكتسب هذا أهمية خاصة عندما لا تنتهي صلاحية قيمة الحداثة عند حد بايت صحيح.
  • قيمة إرجاع: عند توليد قيم حديثة بواسطة FVM، تُرجع الدالة المعنية نسخة من apext::tsync::FVContainer. بعد ذلك، يقرأ سياق الاستدعاء عبر length [SWS_TS_14195] الطول الفعلي بالبتات الذي حدده FVM ويستخرج البايتات المقابلة من value [SWS_TS_14196] لتضمينها في بروتوكولات الأمان اللاحقة.

تفسير: من المحتمل أن يتوافق عدد البتات المخزن في length دائمًا مع حجم البايت المقرّب لأعلى للمتجه value، بحيث يمكن تحديد البتات المتبقية غير المستخدمة بالكامل في البايت الأخير من المتجه بدقة من خلال بيان الطول. سؤال Q-e8feae8a93c14191 (مفتوح)

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

مخطط الفئات UML

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

G napext__tsync__FVContainer955 «struct» FVContainer + length + value

الثوابت

length متغير

Length in bits of the freshness value passed in apext::tsync::FVContainer.

std::uint64_t length;
value متغير

Vector of bytes containing the freshness value. Depending on whether the container is used as an input or returning value by the method it will contain either the full freshness or truncated values.

ara::core::Vector<std::uint8_t> value;

توثيق الثوابت / المتغيرات

متغير length [SWS_TS_14195] Upstream: RS_TS_20072 لم يُستورد النص بعد

std::uint64_t length;

Length in bits of the freshness value passed in apext::tsync::FVContainer.

Header-Datei#include "apext/tsync/fvm.h"
Scopestruct apext::tsync::FVContainer
Symbollength
Typstd::uint64_t

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

Record
AUTOSAR/AP/record/SWS_TS_14195
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_14195@rel:R25-11#ae712457
Content hash
ae712457
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_14195
Status: valid/unmigrated Version: rel:R25-11#1a60b5d0 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_14195@rel:R25-11#1a60b5d0
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#241ca1b42026-09-30
  • R24-11rel:R24-11#c95748132026-10-14
  • R25-11rel:R25-11#1a60b5d02026-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

متغير value [SWS_TS_14196] Upstream: RS_TS_20072 لم يُستورد النص بعد

ara::core::Vector<std::uint8_t> value;

Vector of bytes containing the freshness value. Depending on whether the container is used as an input or returning value by the method it will contain either the full freshness or truncated values.

Header-Datei#include "apext/tsync/fvm.h"
Scopestruct apext::tsync::FVContainer
Symbolvalue
Typara::core::Vector< std::uint8_t >

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

Record
AUTOSAR/AP/record/SWS_TS_14196
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_14196@rel:R25-11#89c2ba8a
Content hash
89c2ba8a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_14196
Status: valid/unmigrated Version: rel:R25-11#10d15c84 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_14196@rel:R25-11#10d15c84
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#4559dfb42026-09-30
  • R24-11rel:R24-11#10d15c842026-10-14
  • R25-11rel:R25-11#10d15c842026-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