命名空间 ara::rds

该命名空间为通过网络连接发送和接收二进制原始数据流以及时间敏感型 AVTP 音视频流提供功能接口 AUTOSAR_AP_SWS_RawDataStream §1。应用程序通过客户端和服务器类建立点对点连接，或利用专用的生产者和消费者类传输类型化数据报。读取操作以结构化方式在结果对象中提供接收到的原始数据。传输期间的错误状态通过模块特定的错误域和标准化错误代码来指示 [SWS_RDS_12367]。

更多 ›

上下文

命名空间 ara::rds 在 AUTOSAR Adaptive Platform 内为通过网络连接传输二进制原始数据流（Raw Data Streams）提供功能接口 AUTOSAR_AP_SWS_RawDataStream §1。该架构支持两种互补的通信模式：非结构化字节流的通用点对点传输，以及符合 IEEE 1722 标准（音频视频传输协议，AVTP）的类型化数据报时间敏感型流传输。

对于字节流传输，RawDataStreamClient 和 RawDataStreamServer 构成了核心组件。RawDataStreamClient 发起网络连接并处理后续的读写操作，而 RawDataStreamServer 则接收并管理传入的连接请求。读取操作的结果被封装在类 ReadDataResult 的实例中，以便将接收到的数据块以结构化方式传递给应用程序逻辑。

对于时间敏感型音频、视频和控制流，ara::rds 定义了类型化流模型：IEEE1722RawDataStreamProducer 用作生成和发送 IEEE 1722 数据报的源，而 IEEE1722RawDataStreamConsumer 则用作接收这些数据报的汇。有效载荷和协议头通过专用数据报类型进行映射，例如 IEEE1722DatagramAAF（音频）、IEEE1722DatagramRVF（视频）、IEEE1722DatagramCRF（时钟参考）以及控制数据报（IEEE1722Datagram61883_IIDC、IEEE1722DatagramNTSCF、IEEE1722DatagramTSCF 和基础数据报 IEEE1722Datagram）。通用头部字段封装了 IEEE1722DatagramAVTPDUCommonHeaderFields 和 IEEE1722DatagramAVTPDUCommonStreamHeaderFields。

上下文图：客户端/服务器流式传输类以及 IEEE 1722 流式传输组件与 ara::rds 中的错误域之间的交互。来源：[SWS_RDS_11298]、[SWS_RDS_11299]、[SWS_RDS_12367]、AUTOSAR_AP_SWS_RawDataStream §1。

使用路径

在字节流通信的常规操作流程中，服务器进程首先实例化 RawDataStreamServer，以在网络上等待传入连接。客户端进程创建 RawDataStreamClient 的实例并建立到服务器的网络连接。一旦连接建立，通信双方即可执行读取或写入调用。每次读取调用都会返回一个 ReadDataResult，其中提供读取的二进制数据以供进一步处理。

在 AVTP 场景中，数据生产者实例化一个 IEEE1722RawDataStreamProducer 并通过 IEEE1722DatagramAVTPDUCommonStreamHeaderFields 配置所需的协议头和流头。有效数据被打包进特定领域的数据报中，例如 IEEE1722DatagramAAF 或 IEEE1722DatagramRVF。Interpretation：传输至 IEEE1722RawDataStreamConsumer 通常可能通过 AVB/TSN 网络进行，随后消费者接收并解码类型化数据报。 问题 Q-3502e4b3d8365e69 (未决)

错误场景

ara::rds 中的错误处理无缝融入 Adaptive Platform 的模型，并基于错误域和错误代码 AUTOSAR_AP_SWS_RawDataStream §1。该模块定义了错误域 RdsErrorDomain，其实例可通过函数 GetRdsErrorDomain() 获取 [SWS_RDS_11298]。

具体的错误情况，例如传输中止或连接冲突，通过枚举 RdsErrc 进行映射 [SWS_RDS_12367]。为了生成模块特定的错误对象，该命名空间提供了辅助函数 MakeErrorCode(RdsErrc code, ara::core::ErrorDomain::SupportDataType data) [SWS_RDS_11299]。Interpretation：流类的失败 I/O 操作可能会返回相应的 ara::core::ErrorCode。 问题 Q-16627290fe526e68 (未决)对于基于异常的执行路径，还存在专用类型 RdsException。