DEENESPTFRRUARHIKOZHNL

class ara::rds::IEEE1722RawDataStreamProducer

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_90322] · Header ara/rds/raw_data_stream_IEEE1722.h

template<typename T> class IEEE1722RawDataStreamProducer final {...};

Producer for typed IEEE 1722 stream datagrams.

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

User GuideAI-GENERATED

Enables the typed transmission of IEEE 1722 data stream datagrams via a configured connection.
AI-GENERATED unreviewed Model: gemini-3.8-flash-medium · Effort: medium · Temperature: not controllable · Prompt: 4f4ec9f5aa38 Provenance Open questions (2)
translated from the German guidegemini-3.8-flash-low · 2026-10-13 · German original

Enables the typed transmission of IEEE 1722 data stream datagrams via a configured connection.

The template class ara::rds::IEEE1722RawDataStreamProducer serves in the AUTOSAR Adaptive Platform to send typed data stream datagrams according to the IEEE 1722 standard (AUTOSAR_AP_SWS_RawDataStream, p. 1). Following static creation using Create, the connection is established via Connect, whereupon payload data is transmitted as a vector via WriteData [SWS_RDS_90332]. The class features strict move-only semantics and is not thread-safe for move operations or in the destructor. An explicit invocation of Shutdown or the destruction of the object terminates the connection properly.

Context

The template class ara::rds::IEEE1722RawDataStreamProducer provides the interface for sending typed data stream datagrams according to the IEEE 1722 standard (AUTOSAR_AP_SWS_RawDataStream, p. 1) within the module rds (Raw Data Stream) of the AUTOSAR Adaptive Platform. As a producer component, it encapsulates channel- and protocol-specific connection establishment as well as the transport of payload data across the underlying network.

Addressing and software-side binding to a configured stream instance are performed by passing an ara::core::InstanceSpecifier to the creation method [SWS_RDS_90323]. Primary interaction partners are the using software, which generates data elements of the template type T, and the IEEE 1722 network stack, which physically transports the datagrams. The class definition is included via header #include "ara/rds/raw_data_stream_IEEE1722.h" [SWS_RDS_90323].

Lifecycle

Instantiation of ara::rds::IEEE1722RawDataStreamProducer occurs exclusively via the static factory method Create [SWS_RDS_90323]. The class is subject to strict move-only semantics: The copy constructor [SWS_RDS_90327] and the copy assignment operator [SWS_RDS_90328] are deleted (=delete), thereby preventing resource duplication.

Transferring the instance to other owners is possible via the move constructor [SWS_RDS_90324] and the move assignment operator [SWS_RDS_90326]. Regarding concurrency, move operations and the destructor are declared as not thread-safe [SWS_RDS_90324], [SWS_RDS_90326], [SWS_RDS_90329]; concurrent access from different threads requires external synchronization.

After creation, the producer is initially in the disconnected state. The connection is established via Connect [SWS_RDS_90330]. Termination of the connection occurs either explicitly via Shutdown [SWS_RDS_90331] or automatically upon destruction of the instance: The destructor ~IEEE1722RawDataStreamProducer() ensures that an open connection is shut down [SWS_RDS_90329].

Lebenszyklus NichtInitialisiert Not initialized Erzeugt Created (not connected) NichtInitialisiert->Erzeugt Create() Verbunden Verbunden Erzeugt->Verbunden Connect() Beendet Beendet Erzeugt->Beendet ~IEEE1722RawDataStreamProducer() Verbunden->Verbunden WriteData() Verbunden->Beendet Shutdown() / ~IEEE1722RawDataStreamProducer()

State diagram: Lifecycle phases of the producer from creation through connection establishment to closure. Sources: [SWS_RDS_90323], [SWS_RDS_90330], [SWS_RDS_90331], [SWS_RDS_90329], [SWS_RDS_90332].

Usage Path

The regular sequence for transmitting IEEE 1722 data streams is divided into the following phases:

  1. Creation: The application instantiates the producer via Create, specifying the instance identifier [SWS_RDS_90323], and takes ownership of the returned instance.
  2. Connection establishment: Before transmitting data, the application calls Connect [SWS_RDS_90330] to open the communication channel.
  3. Data transmission: Datagrams are then passed to the network as a vector of type T using WriteData(std::vector<T> data) [SWS_RDS_90332]. This step can be repeated cyclically or in an event-driven manner.
  4. Connection teardown: After transmissions are complete, Shutdown terminates the connection explicitly [SWS_RDS_90331]. Alternatively, the destructor closes the connection when leaving scope [SWS_RDS_90329].
Typical sequence when sending IEEE 1722 telegramsApplikationIEEE1722RawDataStreamProducerUse Case: Initialization and connection establishmentCreate(instance)Result<IEEE1722RawDataStreamProducer>Connect()Result<void>Use Case: Data transmissionloopDaten vorhandenWriteData(data)Result<void>Use Case: VerbindungsabbauShutdown()Result<void>

Sequence diagram: Typical sequence of data transmission from instantiation to connection teardown. Sources: [SWS_RDS_90323], [SWS_RDS_90330], [SWS_RDS_90332], [SWS_RDS_90331].

Error Scenarios

The operations of the class are specified as noexcept and utilize the error model ara::core::Result:

  • Create returns an ara::core::Result<IEEE1722RawDataStreamProducer<T>> [SWS_RDS_90323]. In case of faulty configuration or lack of resources, the result contains a corresponding error code instead of an instance.
  • Connect reports a connection establishment failure via ara::core::Result<void> [SWS_RDS_90330].
  • WriteData returns an ara::core::Result<void> [SWS_RDS_90332]. Interpretation: An invocation presumably requires prior successful connection establishment using Connect; if a connection is missing or internal transmission errors occur, an error is reported. Question Q-ee438b8710c58062 (open)
  • Shutdown signals any errors during connection closure likewise via an ara::core::Result<void> [SWS_RDS_90331].

Interpretation: Concrete ara::core::ErrorCode values are not specified in the interface extract and must be checked application-specifically via the returned Result. Question Q-472e6d4a603c883d (open)

This guide is based exclusively on the AUTOSAR Adaptive R25-11 interface specification and was automatically generated.

Member map

Detail view

Select an entry in the outline.

Constructors and destructor

Copy constructor is not allowed.

Overloads IEEE1722RawDataStreamProducer 2
IEEE1722RawDataStreamProducer(const IEEE1722RawDataStreamProducer &)=delete; SWS_RDS_90327
IEEE1722RawDataStreamProducer(IEEE1722RawDataStreamProducer &&other) noexcept; SWS_RDS_90324

Destructor; an open connection is shut down.

~IEEE1722RawDataStreamProducer() noexcept;

Methods

Connect function

Connects the IEEE 1722 stream producer.

ara::core::Result<void> Connect() noexcept;
Create function

Creates an IEEE 1722 producer.

static ara::core::Result<IEEE1722RawDataStreamProducer<T>> Create(const ara::core::InstanceSpecifier &instance) noexcept;
Shutdown function

Shuts down the producer connection.

ara::core::Result<void> Shutdown() noexcept;
WriteData function

Writes IEEE 1722 datagrams.

ara::core::Result<void> WriteData(std::vector<T> data) noexcept;

Operators

operator= function 2

Copy assignment operator is not allowed.

Overloads = 2
IEEE1722RawDataStreamProducer &operator=(const IEEE1722RawDataStreamProducer &)=delete; SWS_RDS_90328
IEEE1722RawDataStreamProducer &operator=(IEEE1722RawDataStreamProducer &&other) & noexcept; SWS_RDS_90326

Documentation of methods and types

function IEEE1722RawDataStreamProducer [SWS_RDS_90327]

IEEE1722RawDataStreamProducer(const IEEE1722RawDataStreamProducer &)=delete;

Copy constructor is not allowed.

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

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

Record
AUTOSAR/AP/record/SWS_RDS_90327
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90327@rel:R25-11#c6f04c48
Content hash
c6f04c48
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90327
Status: valid/unmigrated Version: rel:R25-11#e5a42a2f 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_90327@rel:R25-11#e5a42a2f
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#c6f04c482026-09-30
  • R24-11rel:R24-11#e5a42a2f2026-10-14
  • R25-11rel:R25-11#e5a42a2f2026-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 IEEE1722RawDataStreamProducer [SWS_RDS_90324]

IEEE1722RawDataStreamProducer(IEEE1722RawDataStreamProducer &&other) noexcept;

Move constructor.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722RawDataStreamProducer
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_RDS_90324
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90324@rel:R25-11#6eccec19
Content hash
6eccec19
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90324
Status: valid/unmigrated Version: rel:R25-11#ed095031 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_90324@rel:R25-11#ed095031
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#6eccec192026-09-30
  • R24-11rel:R24-11#ed0950312026-10-14
  • R25-11rel:R25-11#ed0950312026-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 operator= [SWS_RDS_90328]

IEEE1722RawDataStreamProducer &operator=(const IEEE1722RawDataStreamProducer &)=delete;

Copy assignment operator is not allowed.

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

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

Record
AUTOSAR/AP/record/SWS_RDS_90328
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90328@rel:R25-11#eaae76f2
Content hash
eaae76f2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90328
Status: valid/unmigrated Version: rel:R25-11#d9f22fa2 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_90328@rel:R25-11#d9f22fa2
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#eaae76f22026-09-30
  • R24-11rel:R24-11#d9f22fa22026-10-14
  • R25-11rel:R25-11#d9f22fa22026-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 operator= [SWS_RDS_90326]

IEEE1722RawDataStreamProducer &operator=(IEEE1722RawDataStreamProducer &&other) & noexcept;

Move assignment operator.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722RawDataStreamProducer
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_RDS_90326
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90326@rel:R25-11#019c358d
Content hash
019c358d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90326
Status: valid/unmigrated Version: rel:R25-11#77a790e4 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_90326@rel:R25-11#77a790e4
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#019c358d2026-09-30
  • R24-11rel:R24-11#77a790e42026-10-14
  • R25-11rel:R25-11#77a790e42026-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 ~IEEE1722RawDataStreamProducer [SWS_RDS_90329]

~IEEE1722RawDataStreamProducer() noexcept;

Destructor; an open connection is shut down.

Header-Datei#include "ara/rds/raw_data_stream_IEEE1722.h"
Scopeclass ara::rds::IEEE1722RawDataStreamProducer
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_RDS_90329
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90329@rel:R25-11#6c7e14a6
Content hash
6c7e14a6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90329
Status: valid/unmigrated Version: rel:R25-11#a0af2838 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_90329@rel:R25-11#a0af2838
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#6c7e14a62026-09-30
  • R24-11rel:R24-11#a0af28382026-10-14
  • R25-11rel:R25-11#a0af28382026-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 Connect [SWS_RDS_90330]

ara::core::Result<void> Connect() noexcept;

Connects the IEEE 1722 stream producer.

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

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

Record
AUTOSAR/AP/record/SWS_RDS_90330
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90330@rel:R25-11#60092d92
Content hash
60092d92
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90330
Status: valid/unmigrated Version: rel:R25-11#cd9ebb3d 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_90330@rel:R25-11#cd9ebb3d
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#60092d922026-09-30
  • R24-11rel:R24-11#89d5b0f42026-10-14
  • R25-11rel:R25-11#cd9ebb3d2026-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 Shutdown [SWS_RDS_90331]

ara::core::Result<void> Shutdown() noexcept;

Shuts down the producer connection.

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

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

Record
AUTOSAR/AP/record/SWS_RDS_90331
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90331@rel:R25-11#c8f38c64
Content hash
c8f38c64
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90331
Status: valid/unmigrated Version: rel:R25-11#34c26504 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_90331@rel:R25-11#34c26504
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#c8f38c642026-09-30
  • R24-11rel:R24-11#68ca17352026-10-14
  • R25-11rel:R25-11#34c265042026-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 WriteData [SWS_RDS_90332]

ara::core::Result<void> WriteData(std::vector<T> data) noexcept;

Writes IEEE 1722 datagrams.

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

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

Record
AUTOSAR/AP/record/SWS_RDS_90332
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90332@rel:R25-11#5ab525c8
Content hash
5ab525c8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90332
Status: valid/unmigrated Version: rel:R25-11#488e5e5f 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_90332@rel:R25-11#488e5e5f
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#5ab525c82026-09-30
  • R24-11rel:R24-11#953ee92e2026-10-14
  • R25-11rel:R25-11#488e5e5f2026-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 Create [SWS_RDS_90323]

static ara::core::Result<IEEE1722RawDataStreamProducer<T>> Create(const ara::core::InstanceSpecifier &instance) noexcept;

Creates an IEEE 1722 producer.

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

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

Record
AUTOSAR/AP/record/SWS_RDS_90323
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_RDS_90323@rel:R25-11#84598508
Content hash
84598508
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_RawDataStream.pdf#nameddest=SWS_RDS_90323
Status: valid/unmigrated Version: rel:R25-11#d9dfc519 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_90323@rel:R25-11#d9dfc519
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#845985082026-09-30
  • R24-11rel:R24-11#a86036322026-10-14
  • R25-11rel:R25-11#d9dfc5192026-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