namespace ara::rds

O namespace disponibiliza interfaces funcionais para o envio e a receção de fluxos de dados em bruto binários através de ligações de rede, bem como para fluxos de áudio e vídeo AVTP com requisitos temporais críticos AUTOSAR_AP_SWS_RawDataStream §1. As aplicações estabelecem ligações ponto a ponto através de classes de cliente e servidor ou utilizam classes dedicadas de produtor e consumidor para a transmissão de datagramas tipificados. As operações de leitura disponibilizam os dados em bruto recebidos de forma estruturada em objetos de resultado. Os estados de erro durante a transmissão são sinalizados através de um domínio de erro específico do módulo e de códigos de erro normalizados [SWS_RDS_12367].

mais ›

Contexto

O namespace ara::rds disponibiliza, na AUTOSAR Adaptive Platform, interfaces funcionais para a transmissão de fluxos de dados em bruto binários (Raw Data Streams) através de ligações de rede AUTOSAR_AP_SWS_RawDataStream §1. A arquitetura suporta dois padrões de comunicação complementares: a transmissão genérica ponto a ponto de fluxos de bytes não estruturados e o streaming com requisitos temporais críticos de datagramas tipificados de acordo com a norma IEEE 1722 (Audio Video Transport Protocol, AVTP).

Para a transmissão de fluxos de bytes, RawDataStreamClient e RawDataStreamServer constituem os componentes centrais. O RawDataStreamClient inicia uma conexão de rede e processa operações subsequentes de leitura e escrita, enquanto o RawDataStreamServer recebe e gerencia solicitações de conexão recebidas. Os resultados de operações de leitura são encapsulados em instâncias da classe ReadDataResult a fim de transferir blocos de dados recebidos de forma estruturada para a lógica da aplicação.

Para fluxos de áudio, vídeo e controle com requisitos temporais críticos, o ara::rds define um modelo de streaming tipificado: IEEE1722RawDataStreamProducer serve como fonte para a geração e o envio de datagramas IEEE 1722, enquanto IEEE1722RawDataStreamConsumer atua como sumidouro para sua recepção. As cargas úteis e os cabeçalhos de protocolo são mapeados por meio de tipos de datagrama especializados, tais como IEEE1722DatagramAAF (áudio), IEEE1722DatagramRVF (vídeo), IEEE1722DatagramCRF (Clock Reference), bem como datagramas de controle (IEEE1722Datagram61883_IIDC, IEEE1722DatagramNTSCF, IEEE1722DatagramTSCF e o datagrama base IEEE1722Datagram). Campos de cabeçalho comuns são encapsulados por IEEE1722DatagramAVTPDUCommonHeaderFields e IEEE1722DatagramAVTPDUCommonStreamHeaderFields.

Diagrama de contexto: interação entre as classes de streaming cliente/servidor e os componentes de streaming IEEE 1722 com o domínio de erro em ara::rds. Fontes: [SWS_RDS_11298], [SWS_RDS_11299], [SWS_RDS_12367], AUTOSAR_AP_SWS_RawDataStream §1.

Caminho de utilização

No fluxo operacional regular de uma comunicação por fluxo de bytes, um processo servidor instancia inicialmente RawDataStreamServer para aguardar conexões de entrada na rede. Um processo cliente cria uma instância de RawDataStreamClient e estabelece a conexão de rede com o servidor. Assim que a conexão estiver estabelecida, os parceiros de comunicação executam chamadas de leitura ou escrita. Cada chamada de leitura fornece um ReadDataResult, que disponibiliza os dados binários lidos para processamento posterior.

No cenário AVTP, um produtor de dados instancia um IEEE1722RawDataStreamProducer e configura os cabeçalhos de protocolo e de fluxo desejados por meio de IEEE1722DatagramAVTPDUCommonStreamHeaderFields. Os dados úteis são empacotados em datagramas específicos do domínio, como IEEE1722DatagramAAF ou IEEE1722DatagramRVF. Interpretação: a transmissão para o IEEE1722RawDataStreamConsumer deve ocorrer tipicamente por meio de uma rede AVB/TSN, após o que o consumidor recebe e decodifica os datagramas tipificados. Pergunta Q-3502e4b3d8365e69 (aberta)

Cenários de erro

O tratamento de erros em ara::rds integra-se perfeitamente ao modelo da Adaptive Platform e baseia-se em domínios de erro e códigos de erro AUTOSAR_AP_SWS_RawDataStream §1. O módulo define o domínio de erro RdsErrorDomain, cuja instância pode ser obtida por meio da função GetRdsErrorDomain() [SWS_RDS_11298].

Situações concretas de erro, como interrupções de transmissão ou conflitos de conexão, são mapeadas por meio da enumeração RdsErrc [SWS_RDS_12367]. Para a criação de objetos de erro específicos do módulo, o namespace disponibiliza a função auxiliar MakeErrorCode(RdsErrc code, ara::core::ErrorDomain::SupportDataType data) [SWS_RDS_11299]. Interpretação: operações de I/O das classes de streaming que falharem devem retornar um ara::core::ErrorCode correspondente. Pergunta Q-16627290fe526e68 (aberta) Para fluxos de execução baseados em exceções, existe também o tipo especializado RdsException.