네임스페이스 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 표준(Audio Video Transport Protocol, AVTP)에 따른 타입화된 데이터그램의 시간 임계적 스트리밍입니다.

바이트 스트림 전송의 경우 RawDataStreamClient과 RawDataStreamServer이 핵심 컴포넌트를 구성합니다. RawDataStreamClient는 네트워크 연결을 시작하고 후속 읽기 및 쓰기 작업을 처리하는 반면, RawDataStreamServer은 수신 연결 요청을 수신하고 관리합니다. 수신된 데이터 블록을 애플리케이션 로직에 구조화된 방식으로 전달하기 위해 읽기 작업의 결과는 클래스 ReadDataResult의 인스턴스로 캡슐화됩니다.

시간 임계적인 오디오, 비디오 및 제어 스트림을 위해 ara::rds은 타입화된 스트리밍 모델을 정의합니다: IEEE1722RawDataStreamProducer은 IEEE 1722 데이터그램의 생성 및 전송을 위한 소스 역할을 하며, IEEE1722RawDataStreamConsumer는 이들의 수신을 위한 싱크 역할을 합니다. 페이로드 및 프로토콜 헤더는 IEEE1722DatagramAAF(오디오), IEEE1722DatagramRVF(비디오), IEEE1722DatagramCRF(클록 참조) 및 제어 데이터그램(IEEE1722Datagram61883_IIDC, IEEE1722DatagramNTSCF, IEEE1722DatagramTSCF 및 기본 데이터그램 IEEE1722Datagram)과 같은 특수 데이터그램 타입을 통해 매핑됩니다. 공통 헤더 필드는 IEEE1722DatagramAVTPDUCommonHeaderFields 및 IEEE1722DatagramAVTPDUCommonStreamHeaderFields을 캡슐화합니다.

컨텍스트 다이어그램: ara::rds에서 클라이언트/서버 스트리밍 클래스 및 IEEE 1722 스트리밍 컴포넌트와 오류 도메인의 상호작용. 출처: [SWS_RDS_11298], [SWS_RDS_11299], [SWS_RDS_12367], AUTOSAR_AP_SWS_RawDataStream §1.

사용 경로

바이트 스트림 통신의 일반적인 동작 흐름에서 서버 프로세스는 먼저 RawDataStreamServer을 인스턴스화하여 네트워크에서 수신 연결을 대기합니다. 클라이언트 프로세스는 RawDataStreamClient의 인스턴스를 생성하고 서버에 대한 네트워크 연결을 설정합니다. 연결이 설정되면 통신 파트너는 읽기 또는 쓰기 호출을 실행합니다. 각 읽기 호출은 추가 처리를 위해 읽은 바이너리 데이터를 제공하는 ReadDataResult를 반환합니다.

AVTP 시나리오에서 데이터 프로듀서는 IEEE1722RawDataStreamProducer을 인스턴스화하고 IEEE1722DatagramAVTPDUCommonStreamHeaderFields을 통해 원하는 프로토콜 및 스트림 헤더를 구성합니다. 페이로드는 IEEE1722DatagramAAF 또는 IEEE1722DatagramRVF과 같은 도메인별 데이터그램으로 패키징됩니다. 해석: IEEE1722RawDataStreamConsumer로의 전송은 일반적으로 AVB/TSN 네트워크를 통해 이루어질 것으로 추정되며, 이후 컨슈머는 타입화된 데이터그램을 수신하고 디코딩합니다. 질문 Q-3502e4b3d8365e69 (열림)

오류 시나리오

ara::rds의 오류 처리는 Adaptive Platform의 모델에 원활하게 통합되며 오류 도메인과 오류 코드를 기반으로 합니다 AUTOSAR_AP_SWS_RawDataStream §1. 이 모듈은 함수 GetRdsErrorDomain()을 통해 인스턴스를 가져올 수 있는 오류 도메인 RdsErrorDomain를 정의합니다 [SWS_RDS_11298].

전송 중단이나 연결 충돌과 같은 구체적인 오류 상황은 열거형 RdsErrc을 통해 표현됩니다 [SWS_RDS_12367]. 네임스페이스는 모듈 특정 오류 객체를 생성하기 위해 헬퍼 함수 MakeErrorCode(RdsErrc code, ara::core::ErrorDomain::SupportDataType data)를 제공합니다 [SWS_RDS_11299]. 해석: 스트리밍 클래스의 실패한 I/O 작업은 해당 ara::core::ErrorCode를 반환할 것으로 추정됩니다. 질문 Q-16627290fe526e68 (열림) 예외 기반 실행 경로를 위해 특수 타입 RdsException도 존재합니다.