DEENESPTFRRUARHIKOZHNL

struct ara::tsync::TimeMasterMeasurementType

[SWS_TS_00414] Upstream: RS_TS_00034 Wortlaut noch nicht übernommen

struct TimeMasterMeasurementType final {...};

Structure with detailed data for validation of the Time Master .

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

User GuideKI-GENERIERT

Dient der Erfassung von Sendezeitstempeln und Frame-Sequenzen zur Validierung eines Time Masters im Netzwerk.
KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 2ead85402aa5 Herkunft Offene Fragen (3)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Dient der Erfassung von Sendezeitstempeln und Frame-Sequenzen zur Validierung eines Time Masters im Netzwerk.

Die Datenstruktur dient der Zusammenführung von detaillierten Messdaten zur messtechnischen Validierung und Laufzeitüberwachung des Time Masters. Bei jedem versendeten Synchronisationsrahmen bündelt sie den Sendezeitpunkt in der globalen Zeitbasis über preciseOriginTimestamp [SWS_TS_14140], den netzwerkbezogenen Sendezeitstempel syncEgressTimestamp sowie die Ethernet-Rahmenkennung sequenceId [SWS_TS_14142]. Diese aggregierten Messwerte ermöglichen nachgelagerten Analyseinstanzen eine lückenlose Plausibilisierung von Jitter und Paketabfolgen. Da der Typ als finaler Datenbehälter ohne eigene Synchronisation deklariert ist, erfordert ein nebenläufiger Austausch vermutlich zusätzliche Absicherungen durch den Aufrufer. Frage (offen)

Kontext

Die Struktur ara::tsync::TimeMasterMeasurementType ist Bestandteil der Zeitvalidierung (Time Validation) im Modul tsync der AUTOSAR Adaptive Platform. Gemäß Spezifikation bündelt sie detaillierte Messdaten zur Validierung eines Time Masters. In verteilten Systemen stellt der Time Master die zeitliche Referenz für angeschlossene Netzwerkknoten bereit. Um die Einhaltung geforderter Synchronisationsgenauigkeiten sicherzustellen und zeitliche Abweichungen im laufenden Betrieb zu erkennen, werden messtechnische Kenndaten direkt an den Schnittstellen des Time Masters erfasst.

Die Definition des Typs ist in der Header-Datei ara/tsync/time_validation_measurement_types.h hinterlegt [SWS_TS_14140]. Als zentrales Datentransferobjekt führt die Struktur drei elementare Messgrößen zusammen, die beim Aussenden von Synchronisations-Nachrichten (Sync-Frames) über Ethernet entstehen:

  • preciseOriginTimestamp: Der Sendezeitpunkt (Egress Timestamp) des Sync-Frames bezogen auf die globale Zeitbasis im Format ara::tsync::Timestamp [SWS_TS_14140].
  • syncEgressTimestamp: Der netzwerknahe Sendezeitpunkt des Sync-Frames als 64-Bit-Ganzzahl (std::uint64_t) [SWS_TS_14141].
  • sequenceId: Die Sequenzkennung des gesendeten Ethernet-Frames als 16-Bit-Wert (std::uint16_t) [SWS_TS_14142].

Die Struktur agiert somit als standardisierte Schnittstelle zwischen dem eigentlichen Synchronisationsdienst des Time Masters und nachgelagerten Überwachungs- bzw. Validierungskomponenten.

Lebenszyklus

Die Deklaration erfolgt als struct TimeMasterMeasurementType final und kennzeichnet die Klasse als finale Datenstruktur mit reiner Wertsemantik. Da sie keine dynamischen Ressourcen verwaltet und keine Vererbungshierarchie aufweist, ist ihre Erzeugung leichtgewichtig. Typischerweise wird eine Instanz unmittelbar nach dem Versenden eines Sync-Frames durch den Time Master erzeugt, sobald der physikalische Sendezeitstempel und die Sequenznummer vorliegen.

Die Lebensdauer eines Exemplars ist eng an den Auswertungszyklus gebunden. Die Daten dürften als Kopie oder über Move-Operationen an die konsumierende Validierungsinstanz übergeben und nach Abschluss der Plausibilitätsprüfung verworfen werden. Frage Q-c09487031c2b5638 (offen) Die Struktur beinhaltet keinerlei interne Synchronisationsmechanismen wie Mutexe. Wird eine Instanz in nebenläufigen Softwarearchitekturen über Thread-Grenzen hinweg ausgetauscht, liegt die Verantwortung für den threadsicheren Zugriff vermutlich vollständig beim Aufrufer.

Nutzungspfad

Der typische Ablauf der Verwendung umfasst die Ermittlung der Messwerte beim Rahmenversand, die Kapselung in der Struktur sowie die Weitergabe zur Validierung:

  1. Versand des Sync-Frames: Der Time Master sendet einen Synchronisationsrahmen über das Ethernet-Netzwerk aus, wobei die Rahmenkennung in sequenceId festgehalten wird [SWS_TS_14142].
  2. Messwerterfassung: Der hardware- oder treibernahe Egress-Zeitpunkt wird als syncEgressTimestamp erfasst [SWS_TS_14141]. Gleichzeitig wird der korrespondierende globale Zeitwert ermittelt und als preciseOriginTimestamp hinterlegt [SWS_TS_14140].
  3. Befüllung der Struktur: Die erfassten Werte werden in einer Instanz von TimeMasterMeasurementType aggregiert.
  4. Auswertung: Die Struktur wird an das Validierungs-Subsystem übergeben, welches anhand der Sequenznummer Paketverluste detektiert und durch Abgleich der Zeitstempel Jitter oder Sendedrifte berechnet.
Ablauf der Messdatenerfassung und -validierung für den Time MasterTimeMasterMessdatenstrukturTimeValidationErzeugung und Zuweisung (preciseOriginTimestamp, syncEgressTimestamp, sequenceId)Bereitstellung von TimeMasterMeasurementTypePlausibilisierung von Zeitstempeln und SequenztreueValidierungsergebnis / Status

Sequenzdiagramm: Typischer Ablauf der Erfassung und Weitergabe von TimeMasterMeasurementType. Quellen: [SWS_TS_14140], [SWS_TS_14141], [SWS_TS_14142].

Interpretation: Durch die gemeinsame Erfassung von lokalem Egress-Zeitstempel [SWS_TS_14141] und globaler Referenzzeit [SWS_TS_14140] kann die Validierungslogik feststellen, ob Verarbeitungsverzögerungen im Protokollstapel des Time Masters aufgetreten sind. Frage Q-7454a019d8b9e764 (offen)

Dieser Leitfaden basiert auf der Spezifikation AUTOSAR Adaptive Platform Release R25-11 und wurde automatisiert erstellt.

Mitgliederkarte

Klassendiagramm

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

G nara__tsync__TimeMasterMeasurementType777 «struct» TimeMasterMeasurementType + preciseOriginTimestamp + sequenceId + syncEgressTimestamp

Detailansicht

Wähle in der Gliederung einen Eintrag aus.

Konstanten

egress timestamp of Sync frame in Global Time

ara::tsync::Timestamp preciseOriginTimestamp;
sequenceId variable

sequence Id of sent Ethernet frame

std::uint16_t sequenceId;

egress timestamp of Sync frame

std::uint64_t syncEgressTimestamp;

Dokumentation der Konstanten / Variablen

variable preciseOriginTimestamp [SWS_TS_14140] Upstream: RS_TS_00034 Wortlaut noch nicht übernommen

ara::tsync::Timestamp preciseOriginTimestamp;

egress timestamp of Sync frame in Global Time

Header-Datei#include "ara/tsync/time_validation_measurement_types.h"
Scopestruct ara::tsync::TimeMasterMeasurementType
SymbolpreciseOriginTimestamp
Typara::tsync::Timestamp

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

Record
AUTOSAR/AP/record/SWS_TS_14140
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_14140@rel:R25-11#f10cc5ac
Content hash
f10cc5ac
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_14140
Status: valid/unmigrated Version: rel:R25-11#6002ae8e 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_14140@rel:R25-11#6002ae8e
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#f10cc5ac2026-09-30
  • R19-11rel:R19-11#93e923d22026-10-14
  • R20-11rel:R20-11#ce0b905d2026-10-14
  • R21-11rel:R21-11#ce0b905d2026-10-14
  • R22-11rel:R22-11#41c0fa062026-10-14
  • R23-11rel:R23-11#6002ae8e2026-10-14
  • R24-11rel:R24-11#6002ae8e2026-10-14
  • R25-11rel:R25-11#6002ae8e2026-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

variable sequenceId [SWS_TS_14142] Upstream: RS_TS_00034 Wortlaut noch nicht übernommen

std::uint16_t sequenceId;

sequence Id of sent Ethernet frame

Header-Datei#include "ara/tsync/time_validation_measurement_types.h"
Scopestruct ara::tsync::TimeMasterMeasurementType
SymbolsequenceId
Typstd::uint16_t

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

Record
AUTOSAR/AP/record/SWS_TS_14142
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_14142@rel:R25-11#cd26e2ee
Content hash
cd26e2ee
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_14142
Status: valid/unmigrated Version: rel:R25-11#6981c39b 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_14142@rel:R25-11#6981c39b
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#cd26e2ee2026-09-30
  • R19-11rel:R19-11#b5b8102f2026-10-14
  • R20-11rel:R20-11#78bfab7c2026-10-14
  • R21-11rel:R21-11#b86ac6202026-10-14
  • R22-11rel:R22-11#6ccb24eb2026-10-14
  • R23-11rel:R23-11#6981c39b2026-10-14
  • R24-11rel:R24-11#6981c39b2026-10-14
  • R25-11rel:R25-11#6981c39b2026-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

variable syncEgressTimestamp [SWS_TS_14141] Upstream: RS_TS_00034 Wortlaut noch nicht übernommen

std::uint64_t syncEgressTimestamp;

egress timestamp of Sync frame

Header-Datei#include "ara/tsync/time_validation_measurement_types.h"
Scopestruct ara::tsync::TimeMasterMeasurementType
SymbolsyncEgressTimestamp
Typstd::uint64_t

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

Record
AUTOSAR/AP/record/SWS_TS_14141
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_14141@rel:R25-11#737d705a
Content hash
737d705a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_14141
Status: valid/unmigrated Version: rel:R25-11#9f2c420d 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_14141@rel:R25-11#9f2c420d
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#737d705a2026-09-30
  • R19-11rel:R19-11#d14b42b02026-10-14
  • R20-11rel:R20-11#73a283f02026-10-14
  • R21-11rel:R21-11#73a283f02026-10-14
  • R22-11rel:R22-11#a5706d0f2026-10-14
  • R23-11rel:R23-11#9f2c420d2026-10-14
  • R24-11rel:R24-11#9f2c420d2026-10-14
  • R25-11rel:R25-11#9f2c420d2026-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