classe ara::rds::IEEE1722Datagram61883_IIDC

La classe ara::rds::IEEE1722Datagram61883_IIDC sert dans le module rds de représentation de datagrammes IEEE 1722 pour les flux de données IEC 61883 et IIDC (AUTOSAR_AP_SWS_RawDataStream p. 1). Elle encapsule des champs de protocole protégés dans ara::core::Optional et fait office de classe de base pour la configuration par couches de paquets de streaming. La destruction s'effectue sans exception via le destructeur virtuel ~IEEE1722Datagram61883_IIDC() noexcept [SWS_RDS_90260]. En tant que condition aux limites essentielle, l'accès non sécurisé aux instances en cas de concurrence requiert une synchronisation externe.

plus ›

Contexte

Au sein du module rds (Raw Data Stream) de l'AUTOSAR Adaptive Platform, la classe ara::rds::IEEE1722Datagram61883_IIDC fait office de représentation structurée de datagrammes IEEE 1722 pour les flux de données IEC 61883 et IIDC (AUTOSAR_AP_SWS_RawDataStream p. 1). Elle reproduit les champs de protocole de la spécification et les conserve dans des éléments protégés. L'ensemble des champs de datagramme – parmi lesquels 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] ainsi que fdf_without_sph [SWS_RDS_90259] – sont dotés du niveau de protection protected. Aucune méthode d'accès publique n'étant spécifiée, la classe devrait principalement servir de classe de base pour des spécialisations de protocole dérivées ou des décodeurs au sein du sous-système de streaming (interprétation : classe de base dans une hiérarchie d'héritage). Le diagramme de contexte suivant illustre l'interaction entre datagramme, spécialisation et traitement de flux. Question Q-e94037851fe92b8d (ouverte)

Diagramme de contexte : intégration de la classe de base de datagramme entre les spécialisations de protocole dérivées et le traitement de flux RDS. Sources : [SWS_RDS_90244], [SWS_RDS_90260], AUTOSAR_AP_SWS_RawDataStream p. 1

Cycle de vie

Les instances de ara::rds::IEEE1722Datagram61883_IIDC sont créées généralement lors de la transmission de données ou lors de la réception de flux audio et vidéo sur le réseau. La destruction et la libération des ressources s'effectuent de façon déterministe via le destructeur virtuel ~IEEE1722Datagram61883_IIDC() noexcept [SWS_RDS_90260]. La déclaration en tant que destructeur virtuel garantit que les classes dérivées sont intégralement nettoyées lors d'une suppression via un pointeur de classe de base, tandis que l'identifiant noexcept garantit qu'aucune exception ne peut être levée lors de la destruction.

Concernant son état interne, la classe ne possède pas de machine à états complexe, mais encapsule son état via des champs ara::core::Optional distincts. Chaque champ, tel que le compteur de blocs de données dbc [SWS_RDS_90254] ou le champ de taille de bloc de données dbs [SWS_RDS_90250], se trouve soit dans un état non défini, soit contient une valeur de protocole valide. En matière de concurrence, le standard ne spécifie aucun mécanisme de synchronisation interne ; un accès simultané en lecture et en écriture à une même instance à travers plusieurs threads ne devrait par conséquent pas être thread-safe (interprétation : absence de synchronisation) et exige une coordination externe. Question Q-e1381bdfdee717e9 (ouverte)

Parcours d'utilisation

Un chemin d'utilisation typique s'accomplit dans des classes dérivées ou dans le cadre de pipelines de streaming pour la création ou l'évaluation de datagrammes :

• Initialisation : une classe dérivée instancie l'objet datagramme pour préparer une opération d'émission ou de réception.
• Configuration des champs : les en-têtes de protocole requis sont définis sélectivement. À cette occasion, des paramètres standard tels que tag [SWS_RDS_90244], channel [SWS_RDS_90245], fmt [SWS_RDS_90256] ainsi que tcode [SWS_RDS_90258] se voient attribuer des valeurs. L'encapsulation dans ara::core::Optional suggère que, selon la déclinaison du sous-format IEEE 1722, il n'est pas impératif de renseigner chaque champ (interprétation : affectation sélective). Question Q-925b6c1d9b5a8ce6 (ouverte)
• Traitement et transmission : les données de datagramme assemblées sont transmises à la couche de transport sous-jacente du module RDS.
• Libération : une fois la transmission ou le traitement des paquets terminé, l'objet est détruit, le destructeur virtuel [SWS_RDS_90260] garantissant un nettoyage polymorphique propre.

Scénarios d'erreur

Puisque ara::rds::IEEE1722Datagram61883_IIDC est définie comme une classe de données, ses méthodes ne signalent aucun code d'erreur AUTOSAR explicite via ara::core::Result. Les sources potentielles d'erreurs proviennent principalement d'une manipulation incorrecte des membres de données optionnels. Un accès à des instances vides de ara::core::Optional sans validation préalable – par exemple lors de la lecture de sid [SWS_RDS_90252], fn [SWS_RDS_90251] ou qpc [SWS_RDS_90249] – peut entraîner des erreurs d'exécution. Comme précondition à l'accès en lecture, les composants dérivés doivent toujours vérifier si le champ concerné est initialisé. De plus, les champs mutuellement dépendants ou alternatifs, tels que fdf_with_sph [SWS_RDS_90257] et fdf_without_sph [SWS_RDS_90259], doivent être définis de manière cohérente les uns avec les autres.