DEENESPTFRRUARHIKOZHNL

class ara::rds::IEEE1722Datagram

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

[SWS_RDS_90225] · Header ara/rds/raw_data_stream_IEEE1722.h

class IEEE1722Datagram {...};

IEEE 1722 datagram representation: IEEE1722Datagram.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopenamespace ara::rds

User GuideAI-GENERATED

Serves as a base class for encapsulating IEEE 1722 payload buffers and length specifications in raw data streaming.
AI-GENERATED unreviewed Model: gemini-3.8-flash-medium · Effort: medium · Temperature: not controllable · Prompt: 187f3b1b82dd Provenance Open questions (2)
translated from the German guidegemini-3.8-flash-low · 2026-10-13 · German original

Serves as a base class for encapsulating IEEE 1722 payload buffers and length specifications in raw data streaming.

The class ara::rds::IEEE1722Datagram serves in module rds as a base class for encapsulating IEEE 1722 streaming datagrams (AUTOSAR_AP_SWS_RawDataStream p. 1). Via the protected attribute data, it manages the dynamic byte buffer in exclusive ownership and holds the respective payload length with stream_data_length. Releasing allocated buffer resources takes place deterministically and without exceptions via the virtual destructor ~IEEE1722Datagram() [SWS_RDS_90228]. Internal synchronization for concurrent accesses does not exist, so cross-thread usages must be guarded externally.

Context

Class ara::rds::IEEE1722Datagram acts in module rds (Raw Data Stream) of the AUTOSAR Adaptive Platform as a base representation for datagrams according to the IEEE 1722 standard (AUTOSAR_AP_SWS_RawDataStream p. 1). It is declared via header ara/rds/raw_data_stream_IEEE1722.h and serves as a structural foundation for transporting time-critical streaming data in the in-vehicle network, particularly via the Audio Video Transport Protocol (AVTP).

Interpretation: By providing protected attributes and a virtual destructor, ara::rds::IEEE1722Datagram is likely to serve as a common base class for various specialized AVTP datagram structures. Question Q-bb382ff193640c8f (open) In this context, the specification defines related types such as IEEE1722DatagramAVTPDUCommonHeaderFields [SWS_RDS_90233], IEEE1722DatagramAVTPDUCommonStreamHeaderFields [SWS_RDS_90242], IEEE1722Datagram61883_IIDC [SWS_RDS_90260], IEEE1722DatagramAAF [SWS_RDS_90273], and IEEE1722DatagramTSCF [SWS_RDS_90275]. Together, these interaction partners represent the protocol framework for different payload formats.

diag_kontext IEEE1722Datagram IEEE1722Datagram IEEE1722DatagramAVTPDUCommonHeaderFields IEEE1722DatagramAVTPDUCommonHeaderFields IEEE1722Datagram->IEEE1722DatagramAVTPDUCommonHeaderFields IEEE1722DatagramAVTPDUCommonStreamHeaderFields IEEE1722DatagramAVTPDUCommonStreamHeaderFields IEEE1722DatagramAVTPDUCommonHeaderFields->IEEE1722DatagramAVTPDUCommonStreamHeaderFields IEEE1722DatagramAAF IEEE1722DatagramAAF IEEE1722DatagramAVTPDUCommonStreamHeaderFields->IEEE1722DatagramAAF IEEE1722DatagramTSCF IEEE1722DatagramTSCF IEEE1722DatagramAVTPDUCommonStreamHeaderFields->IEEE1722DatagramTSCF IEEE1722Datagram61883_IIDC IEEE1722Datagram61883_IIDC IEEE1722DatagramAVTPDUCommonStreamHeaderFields->IEEE1722Datagram61883_IIDC

Context diagram: Classification of ara::rds::IEEE1722Datagram and specialized AVTP datagram structures. Sources: [SWS_RDS_90226], [SWS_RDS_90228], [SWS_RDS_90233], [SWS_RDS_90242], [SWS_RDS_90260], [SWS_RDS_90273], [SWS_RDS_90275]

Lifecycle

The lifecycle of a datagram instance is significantly determined by the management of the associated data buffer and the RAII paradigm. The attribute data is declared protected as std::unique_ptr<ara::core::Byte[]> [SWS_RDS_90226]. This establishes an exclusive ownership relationship: A datagram owns its byte buffer exclusively, preventing accidental copying of large amounts of data at the type level.

Together with the buffer, the length of the valid payload is maintained via the protected field stream_data_length of type std::uint16_t [SWS_RDS_90227]. Resource release takes place deterministically: The class provides a virtual destructor ~IEEE1722Datagram() noexcept [SWS_RDS_90228]. This ensures that when derived instances are destroyed via a pointer to the base class, all resources are released completely and without memory leaks.

Regarding concurrency, the base class contains no internal synchronization mechanisms. Simultaneous access to the same datagram instance from multiple threads presumably requires external coordination by the using component. Question (open)

Usage Path

In a typical processing flow within raw data streaming, usage takes place via concrete protocol specializations such as IEEE1722DatagramAAF [SWS_RDS_90273] or IEEE1722DatagramTSCF [SWS_RDS_90275]:

  • Creation and buffer allocation: A specialized datagram instance is instantiated, and the protected data buffer data is initialized as std::unique_ptr<ara::core::Byte[]> with the required memory area [SWS_RDS_90226].
  • Length specification: The actual payload length of the stream is stored in stream_data_length [SWS_RDS_90227].
  • Passing and processing: Interpretation: The datagram is likely to be transported preferably by means of move semantics through the processing pipeline of module rds in order to avoid unnecessary copy operations of streaming data. Question Q-ff084c9788ec5cdc (open)
  • Destruction: After processing is complete, the datagram leaves its scope; the virtual destructor ~IEEE1722Datagram() is called and the buffer is deallocated automatically [SWS_RDS_90228].

Error Scenarios

Errors when handling ara::rds::IEEE1722Datagram can occur particularly during memory management and boundary checking:

  • Memory allocation error: If the allocation of the dynamic byte array for data fails, this can lead to a standard memory exception (std::bad_alloc) before the datagram is validly provided [SWS_RDS_90226].
  • Length inconsistency: If a value exceeding the real size of the memory allocated via data is entered for stream_data_length, buffer overflows threaten during read accesses [SWS_RDS_90227]. Derived classes must ensure consistency between buffer allocation and length specification.
  • Exception safety during destruction: The destructor is explicitly declared as noexcept [SWS_RDS_90228]. This guarantees that no exceptions are propagated during the destruction of the object, which is essential for the stability of RAII chains.

This guide was generated by an AI based on the AUTOSAR Adaptive R25-11 specification.

Member map

Constructors and destructor

1

Detail view

Select an entry in the outline.

Constructors and destructor

Virtual destructor of the IEEE 1722 datagram type.

~IEEE1722Datagram() noexcept;

Constants

data variable

Protected IEEE 1722 datagram field data.

std::unique_ptr<ara::core::Byte[]> data;

Protected IEEE 1722 datagram field stream_data_length.

std::uint16_t stream_data_length;

Documentation of methods and types

variable data [SWS_RDS_90226]

std::unique_ptr<ara::core::Byte[]> data;

Protected IEEE 1722 datagram field data.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722Datagram
Zugriffprotected

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

Record
AUTOSAR/AP/record/SWS_RDS_90226
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90226@rel:R25-11#036fe33b
Content hash
036fe33b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90226
Status: valid/unmigrated Version: rel:R25-11#cd433d90 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_RDS_90226@rel:R25-11#cd433d90
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#036fe33b2026-09-30
  • R24-11rel:R24-11#cd433d902026-10-14
  • R25-11rel:R25-11#cd433d902026-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 stream_data_length [SWS_RDS_90227]

std::uint16_t stream_data_length;

Protected IEEE 1722 datagram field stream_data_length.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722Datagram
Zugriffprotected

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

Record
AUTOSAR/AP/record/SWS_RDS_90227
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90227@rel:R25-11#0d27ae0d
Content hash
0d27ae0d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90227
Status: valid/unmigrated Version: rel:R25-11#0d5df4da 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_RDS_90227@rel:R25-11#0d5df4da
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#0d27ae0d2026-09-30
  • R24-11rel:R24-11#0d5df4da2026-10-14
  • R25-11rel:R25-11#0d5df4da2026-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

function ~IEEE1722Datagram [SWS_RDS_90228]

~IEEE1722Datagram() noexcept;

Virtual destructor of the IEEE 1722 datagram type.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722Datagram

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

Record
AUTOSAR/AP/record/SWS_RDS_90228
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90228@rel:R25-11#df2abe81
Content hash
df2abe81
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90228
Status: valid/unmigrated Version: rel:R25-11#4395c8db 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_RDS_90228@rel:R25-11#4395c8db
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#df2abe812026-09-30
  • R24-11rel:R24-11#d950a3602026-10-14
  • R25-11rel:R25-11#4395c8db2026-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