classe ara::rds::IEEE1722Datagram61883_IIDC

A classe ara::rds::IEEE1722Datagram61883_IIDC serve no módulo rds como representação de datagramas IEEE 1722 para fluxos de dados IEC 61883 e IIDC (AUTOSAR_AP_SWS_RawDataStream p. 1). Ela encapsula campos de protocolo protegidos em ara::core::Optional e atua como classe base para a configuração em camadas de pacotes de streaming. A destruição ocorre de forma segura contra exceções por meio do destrutor virtual ~IEEE1722Datagram61883_IIDC() noexcept [SWS_RDS_90260]. Como restrição essencial, o acesso não protegido a instâncias em caso de concorrência requer uma sincronização externa.

mais ›

Contexto

A classe ara::rds::IEEE1722Datagram61883_IIDC atua dentro do módulo rds (Raw Data Stream) da AUTOSAR Adaptive Platform como representação estruturada de datagramas IEEE 1722 para fluxos de dados IEC 61883 e IIDC (AUTOSAR_AP_SWS_RawDataStream p. 1). Ela mapeia os campos de protocolo da especificação e os mantém em membros protegidos. Todos os campos de datagrama – incluindo tag [SWS_RDS_90244], channel [SWS_RDS_90245], syt [SWS_RDS_90246], sph [SWS_RDS_90247], qi_2 [SWS_RDS_90248], qpc [SWS_RDS_90249], dbs [SWS_RDS_90250], fn [SWS_RDS_90251], sid [SWS_RDS_90252], sy [SWS_RDS_90253], dbc [SWS_RDS_90254], qi_1 [SWS_RDS_90255], fmt [SWS_RDS_90256], fdf_with_sph [SWS_RDS_90257], tcode [SWS_RDS_90258] e fdf_without_sph [SWS_RDS_90259] – são providos com o nível de proteção protected. Como não estão especificados métodos de acesso públicos, a classe deve servir primariamente como classe base para especializações de protocolo derivadas ou decodificadores dentro do subsistema de streaming (interpretação: classe base na hierarquia de herança). Pergunta Q-e94037851fe92b8d (aberta) A interação entre datagrama, especialização e processamento de stream é ilustrada pelo seguinte diagrama de contexto.

Diagrama de contexto: enquadramento da classe base de datagrama entre especializações de protocolo derivadas e o processamento de stream do RDS. Fontes: [SWS_RDS_90244], [SWS_RDS_90260], AUTOSAR_AP_SWS_RawDataStream p. 1

Ciclo de vida

Instâncias de ara::rds::IEEE1722Datagram61883_IIDC originam-se tipicamente no decurso da transmissão de dados ou na recepção de fluxos de áudio e vídeo através da rede. A destruição e liberação de recursos ocorrem de forma determinística por meio do destrutor virtual ~IEEE1722Datagram61883_IIDC() noexcept [SWS_RDS_90260]. A declaração como destrutor virtual assegura que as classes derivadas sejam completamente limpas na exclusão por meio de ponteiros da classe base, enquanto o identificador noexcept garante que nenhuma exceção pode ser lançada durante a destruição.

Em relação ao estado interno, a classe não possui uma máquina de estados complexa, mas encapsula seu estado por meio de campos ara::core::Optional separados. Cada campo, como o contador de blocos de dados dbc [SWS_RDS_90254] ou o campo de tamanho do bloco de dados dbs [SWS_RDS_90250], encontra-se no estado não definido ou contém um valor de protocolo válido. Quanto à concorrência, o padrão não especifica mecanismos de sincronização internos; um acesso simultâneo de leitura e escrita à mesma instância através de múltiplas threads provavelmente não é thread-safe (interpretação: ausência de sincronização) e requer uma coordenação externa. Pergunta Q-e1381bdfdee717e9 (aberta)

Caminho de utilização

Um caminho típico de utilização ocorre em classes derivadas ou no âmbito de pipelines de streaming para criação ou avaliação de datagramas:

• Inicialização: uma classe derivada instancia o objeto de datagrama para a preparação de um procedimento de envio ou recepção.
• Configuração dos campos: os cabeçalhos de protocolo necessários são definidos seletivamente. Aqui, parâmetros padrão como tag [SWS_RDS_90244], channel [SWS_RDS_90245], fmt [SWS_RDS_90256] bem como tcode [SWS_RDS_90258] são preenchidos com valores. O encapsulamento em ara::core::Optional sugere que, dependendo da variante do subformato IEEE 1722, não é obrigatório preencher todos os campos (interpretação: atribuição seletiva). Pergunta Q-925b6c1d9b5a8ce6 (aberta)
• Processamento e encaminhamento: os dados de datagrama compostos são entregues à camada de transporte subsequente do módulo RDS.
• Liberação: após a conclusão da transmissão ou do processamento de pacotes, o objeto é destruído, com o destrutor virtual [SWS_RDS_90260] garantindo uma limpeza polimórfica correta.

Cenários de erro

Como ara::rds::IEEE1722Datagram61883_IIDC é definida como classe de dados, seus métodos não sinalizam códigos de erro explícitos da AUTOSAR via ara::core::Result. Fontes potenciais de erro surgem principalmente no manuseio incorreto dos membros de dados opcionais. Um acesso a instâncias vazias de ara::core::Optional sem validação prévia – por exemplo, na leitura de sid [SWS_RDS_90252], fn [SWS_RDS_90251] ou qpc [SWS_RDS_90249] – pode levar a erros de tempo de execução. Como pré-condição para o acesso de leitura, componentes derivados devem sempre verificar se o respectivo campo está inicializado. Além disso, campos mutuamente dependentes ou alternativos, como fdf_with_sph [SWS_RDS_90257] e fdf_without_sph [SWS_RDS_90259], devem ser definidos de maneira consistente entre si.