namespace ara::rds

L'espace de noms fournit des interfaces fonctionnelles pour l'émission et la réception de flux de données brutes binaires sur des connexions réseau ainsi que pour des flux audio-vidéo AVTP critiques en temps AUTOSAR_AP_SWS_RawDataStream §1. Les applications établissent des connexions point à point via des classes client et serveur ou utilisent des classes producteur et consommateur dédiées pour transmettre des datagrammes typés. Les opérations de lecture mettent à disposition les données brutes reçues de manière structurée dans des objets de résultat. Les états erronés survenant pendant le transfert sont signalés via un domaine d'erreur spécifique au module et des codes d'erreur standardisés [SWS_RDS_12367].

plus ›

Contexte

L'espace de noms ara::rds fournit au sein de l'AUTOSAR Adaptive Platform des interfaces fonctionnelles pour le transfert de flux de données brutes binaires (Raw Data Streams) sur des connexions réseau AUTOSAR_AP_SWS_RawDataStream §1. L'architecture prend en charge deux modèles de communication complémentaires : le transfert générique point à point de flux d'octets non structurés ainsi que le streaming critique en temps de datagrammes typés selon la norme IEEE 1722 (Audio Video Transport Protocol, AVTP).

Pour le transfert de flux d'octets, RawDataStreamClient et RawDataStreamServer constituent les composants centraux. Le RawDataStreamClient initie une connexion réseau et prend en charge les opérations ultérieures de lecture et d'écriture, tandis que le RawDataStreamServer reçoit et gère les demandes de connexion entrantes. Les résultats des opérations de lecture sont encapsulés dans des instances de la classe ReadDataResult afin de transmettre les blocs de données reçus de façon structurée à la logique applicative.

Pour les flux audio, vidéo et de commande critiques en temps, ara::rds définit un modèle de streaming typé : IEEE1722RawDataStreamProducer sert de source pour la génération et l'émission de datagrammes IEEE 1722, tandis que IEEE1722RawDataStreamConsumer fait office de puits pour leur réception. Les charges utiles et les en-têtes de protocole sont représentés par des types de datagrammes spécialisés tels que IEEE1722DatagramAAF (audio), IEEE1722DatagramRVF (vidéo), IEEE1722DatagramCRF (Clock Reference) ainsi que des datagrammes de commande (IEEE1722Datagram61883_IIDC, IEEE1722DatagramNTSCF, IEEE1722DatagramTSCF et le datagramme de base IEEE1722Datagram). Des champs d'en-tête communs sont encapsulés par IEEE1722DatagramAVTPDUCommonHeaderFields et IEEE1722DatagramAVTPDUCommonStreamHeaderFields.

Diagramme de contexte : interaction des classes de streaming client/serveur et des composants de streaming IEEE 1722 avec le domaine d'erreur dans ara::rds. Sources : [SWS_RDS_11298], [SWS_RDS_11299], [SWS_RDS_12367], AUTOSAR_AP_SWS_RawDataStream §1.

Parcours d'utilisation

Dans le déroulement régulier d'une communication par flux d'octets, un processus serveur instancie d'abord RawDataStreamServer afin d'attendre des connexions entrantes sur le réseau. Un processus client crée une instance de RawDataStreamClient et établit la connexion réseau vers le serveur. Dès que la connexion est établie, les partenaires de communication exécutent des appels de lecture ou d'écriture. Chaque appel de lecture fournit un ReadDataResult, qui met à disposition les données binaires lues pour le traitement ultérieur.

Dans le scénario AVTP, un producteur de données instancie un IEEE1722RawDataStreamProducer et configure les en-têtes de protocole et de flux souhaités via IEEE1722DatagramAVTPDUCommonStreamHeaderFields. Les données utiles sont encapsulées dans des datagrammes spécifiques au domaine tels que IEEE1722DatagramAAF ou IEEE1722DatagramRVF. Interprétation : la transmission vers le IEEE1722RawDataStreamConsumer devrait généralement s'effectuer via un réseau AVB/TSN, après quoi le consommateur reçoit et décode les datagrammes typés. Question Q-3502e4b3d8365e69 (ouverte)

Scénarios d'erreur

Le traitement des erreurs dans ara::rds s'intègre de manière transparente dans le modèle de l'Adaptive Platform et repose sur des domaines d'erreur et des codes d'erreur AUTOSAR_AP_SWS_RawDataStream §1. Le module définit le domaine d'erreur RdsErrorDomain, dont l'instance peut être obtenue via la fonction GetRdsErrorDomain() [SWS_RDS_11298].

Des situations d'erreur concrètes, telles que des interruptions de transfert ou des conflits de connexion, sont représentées via l'énumération RdsErrc [SWS_RDS_12367]. Pour générer des objets d'erreur spécifiques au module, l'espace de noms fournit la fonction utilitaire MakeErrorCode(RdsErrc code, ara::core::ErrorDomain::SupportDataType data) [SWS_RDS_11299]. Interprétation : les opérations d'E/S ayant échoué des classes de streaming devraient renvoyer un ara::core::ErrorCode correspondant. Question Q-16627290fe526e68 (ouverte) Pour les chemins d'exécution basés sur des exceptions, il existe en outre le type spécialisé RdsException.