ADC Driver (Adc)

La fonction synchrone Adc_Init (ID de service 0x00) sert à la configuration initiale et à la mise en service de toutes les unités matérielles ADC ainsi que du pilote ADC conformément à [SWS_Adc_00365]. L'interface est mise à disposition via le fichier d'en-tête Adc.h et ne possède aucune valeur de retour.

Paramètres et variantes de configuration

La transmission des données de configuration s'effectue via le paramètre pointeur ConfigPtr de type const Adc_ConfigType* [SWS_Adc_00365]. L'argument requis dépend de la variante de build choisie :

• En cas d'utilisation de la configuration post-build (Variant PB), ConfigPtr doit pointer vers la structure de données correspondante avec les valeurs d'initialisation.
• Si la variante de précompilation (Variant PC) est utilisée, l'interface exige explicitement la transmission d'un NULL_PTR [SWS_Adc_00365].

Concurrence et intégration système

La fonction Adc_Init est spécifiée comme non réentrante (Non Reentrant) [SWS_Adc_00365]. Interprétation : Étant donné que les unités matérielles sont configurées de manière globale et qu'il n'y a pas de réentrance, l'appel devrait typiquement avoir lieu de manière centralisée lors de l'initialisation du système, avant que d'autres fonctions du module ou conversions ne soient initiées. Question Q-a82e9204ae7a5ab7 (ouverte)

Concernant la gestion de l'énergie, il existe un couplage direct avec des exigences connexes : si l'état d'énergie normal (normal Power State) est demandé en fonctionnement, l'API correspondante doit recourir à des paramètres de configuration situés dans les mêmes conteneurs que les paramètres d'initialisation de Adc_Init [SWS_Adc_00483].

La fonction Adc_SetupResultBuffer initialise le pilote ADC avec l'adresse de début d'un tampon spécifique au groupe pour le stockage des résultats de conversion [SWS_Adc_91000]. Cet appel est impérativement requis après un reset avant de pouvoir démarrer une conversion de groupe [SWS_Adc_91000].

Paramètres et contexte d'appel

• Group : identifiant numérique du groupe de canaux ADC demandé [SWS_Adc_91000].
• DataBufferPtr : pointeur vers le tampon de données (type Adc_ValueGroupType*) dans lequel les résultats sont stockés [SWS_Adc_91000].

La fonction est déclarée réentrante et asynchrone, et est disponible via le fichier d'en-tête Adc.h (ID de service 0x0c) [SWS_Adc_91000].

Valeurs de retour et gestion des erreurs

Le type de retour est Std_ReturnType [SWS_Adc_91000] :

• E_OK : le pointeur vers le tampon de résultats a été initialisé avec succès [SWS_Adc_91000].
• E_NOT_OK : l'opération a échoué ou une erreur de développement est survenue [SWS_Adc_91000].

Obligations de l'application

L'application appelante doit garantir que le tampon vers lequel pointe DataBufferPtr met à disposition un espace mémoire suffisant pour l'ensemble des résultats de conversion du groupe de canaux spécifié [SWS_Adc_91000].

La fonction Adc_DeInit sert à la désinitialisation du pilote ADC et fait passer toutes les unités matérielles ADC associées dans un état comparable à l'état qui suit immédiatement un power-on reset [SWS_Adc_00366]. Elle rétablit ainsi l'état initial du matériel avant une nouvelle initialisation.

Appel et interface

La fonction est déclarée dans le fichier d'en-tête Adc.h et possède l'ID de service 0x01 [SWS_Adc_00366]. L'appel s'effectue de manière synchrone (Synchronous) et ne requiert aucun paramètre (ni In, InOut ni Out) ; aucune valeur de retour n'est non plus fournie (signature void Adc_DeInit(void)) [SWS_Adc_00366]. Aucun paramètre d'entrée ni valeur de retour n'est alors évalué ou généré. En raison de la sémantique synchrone, l'exécution bloque l'appelant jusqu'à ce que la réinitialisation de toutes les unités soit terminée [SWS_Adc_00366].

Concurrence et restrictions

Concernant la concurrence, la fonction est spécifiée comme non réentrante (Non Reentrant) [SWS_Adc_00366]. Il en découle l'interprétation : Des appels simultanés ou chevauchants de Adc_DeInit depuis plusieurs tâches ou différentes couches logicielles ne sont pas autorisés et doivent être coordonnés et évités par l'appelant.

Puisque Adc_DeInit rétablit complètement toutes les unités matérielles ADC dans l'état de reset [SWS_Adc_00366], il conviendrait de s'assurer avant l'appel qu'aucun processus de mesure ou de conversion n'est encore actif, afin d'empêcher un comportement indéfini du matériel. Question Q-15bfa2b822826786 (ouverte)

Utilisation

La fonction Adc_StartGroupConversion démarre la conversion de tous les canaux du groupe de canaux ADC transmis conformément à [SWS_Adc_00367]. L'ID de groupe numérique Group de type Adc_GroupType est transmis en paramètre. La fonction n'a pas de valeur de retour (void) et fonctionne de manière asynchrone ([SWS_Adc_00367]).

Concurrence et restrictions

Selon la spécification, le service est classé réentrant ([SWS_Adc_00367]). Interprétation : Cela devrait signifier que la fonction peut être appelée de manière concurrente pour différents groupes de canaux. Question Q-8283232f222f7b0a (ouverte) Comme le démarrage s'effectue de manière asynchrone, l'appel revient avant la fin de la conversion proprement dite.

Traitement des erreurs et interaction

Le service est disponible via l'en-tête Adc.h et possède l'ID de service 0x02 ([SWS_Adc_00367]). Les codes d'erreur DET ou DEM spécifiques ne sont pas documentés dans le présent payload.

La fonction synchrone Adc_StopGroupConversion met fin à la conversion en cours d'un groupe de canaux ADC demandé [SWS_Adc_00368]. L'interface est déclarée dans l'en-tête Adc.h et spécifiée sous l'ID de service 0x03 [SWS_Adc_00368].

La valeur d'entrée Group de type Adc_GroupType, qui représente l'ID numérique du groupe de canaux ADC respectif, est transmise comme unique paramètre [SWS_Adc_00368]. L'appel ne possède pas de valeur de retour (void) et n'utilise aucun paramètre d'entrée/sortie ni de sortie pure [SWS_Adc_00368].

Concernant le comportement en concurrence, le service est classé comme réentrant et présente une sémantique d'exécution synchrone [SWS_Adc_00368]. Des appels parallèles de l'interface sont par conséquent autorisés. Le comportement synchrone implique que l'opération est immédiatement terminée avec l'appel de fonction [SWS_Adc_00368].

Interprétation : Un appel devrait fonctionnellement présupposer qu'une conversion a été préalablement initiée pour le groupe concerné afin de pouvoir procéder à l'arrêt. Question Q-644ca5344ab849b0 (ouverte) Les codes d'erreur spécifiques, les valeurs de retour pour le signalement d'erreurs ou les messages destinés aux terminaux de développement (DET/DEM) ne sont pas indiqués pour ce service dans le présent extrait de spécification [SWS_Adc_00368].

La fonction synchrone Adc_ReadGroup sert à la lecture des résultats de conversion d'un groupe de canaux ADC issus du cycle de conversion dernièrement achevé ([SWS_Adc_00369]). Elle est disponible via le fichier d'en-tête Adc.h et possède l'ID de service 0x04 ([SWS_Adc_00369]).

Paramètres et disposition du tampon

• Group : Identifiant numérique du groupe de canaux ADC demandé ([SWS_Adc_00369]).
• DataBufferPtr : Pointeur vers le tampon de destination (Adc_ValueGroupType*), à partir de l'adresse duquel les résultats de conversion de tous les canaux du groupe sont déposés ([SWS_Adc_00369]).

Le stockage des valeurs de canaux s'effectue à partir de l'adresse de destination dans l'ordre croissant des canaux ([SWS_Adc_00369]). Cette disposition en mémoire diffère explicitement de l'agencement du tampon lors d'un accès en streaming configuré ([SWS_Adc_00369]). Interprétation : L'appelant devrait être responsable de fournir un tampon suffisamment dimensionné pour tous les canaux du groupe. Question Q-f22a12a6c7ab0eb3 (ouverte)

Valeurs de retour et gestion des erreurs

La valeur de retour de type Std_ReturnType signale l'état de l'opération de lecture ([SWS_Adc_00369]) :

• E_OK : Des résultats sont disponibles et ont été écrits avec succès dans le tampon de données ([SWS_Adc_00369]).
• E_NOT_OK : Aucun résultat n'est disponible ou une erreur de développement est survenue ([SWS_Adc_00369]).

concurrence

La fonction est spécifiée comme réentrante ([SWS_Adc_00369]). Elle peut ainsi être exécutée en parallèle tant que des zones de tampon distinctes sont utilisées pour les accès simultanés.

Utilisation et paramètres

La fonction Adc_EnableHardwareTrigger active le déclencheur matériel pour un groupe de canaux ADC configuré [SWS_Adc_91001]. Elle est définie comme un service avec l'ID de service 0x05 dans le module Adc et est disponible via le fichier d'en-tête Adc.h [SWS_Adc_91001].

• Paramètre d'entrée : l'ID numérique du groupe de canaux ADC souhaité est transmis via le paramètre Group de type Adc_GroupType [SWS_Adc_91001]. Aucun paramètre d'entrée/sortie ou de sortie supplémentaire n'existe [SWS_Adc_91001].
• Valeur de retour : l'interface ne renvoie aucune valeur de retour (void) [SWS_Adc_91001].
• Sémantique asynchrone : le comportement d'exécution est défini comme asynchrone [SWS_Adc_91001]. L'appel autorise le déclenchement, tandis que la conversion effective des canaux n'est amorcée que par des événements matériels ultérieurs.

concurrence

Le pilote spécifie Adc_EnableHardwareTrigger comme réentrante [SWS_Adc_91001]. Interprétation : la réentrance devrait principalement s'appliquer à l'appel simultané avec des groupes de canaux disjoints, étant donné que le déclencheur matériel est activé par groupe de canaux. Question Q-5750576df9f0284d (ouverte)

La fonction Adc_DisableHardwareTrigger sert à désactiver le déclenchement matériel pour un groupe de canaux ADC demandé [SWS_Adc_91002].

Utilisation et sémantique

• Paramètres : Le paramètre Group de type Adc_GroupType est transmis, spécifiant l'ID numérique du groupe de canaux ADC souhaité [SWS_Adc_91002].
• Valeur de retour : La fonction ne possède pas de valeur de retour (void) [SWS_Adc_91002].
• Comportement d'exécution : L'appel est classé comme asynchrone (Sync/Async: Asynchronous) [SWS_Adc_91002]. Cela signifie probablement que l'arrêt effectif ou le découplage de l'événement matériel peut prendre effet de manière différée au niveau du matériel. Question Q-b0e613163b254242 (ouverte)

Concurrence et intégration

L'interface est déclarée comme réentrante (Reentrancy: Reentrant) et est mise à disposition via le fichier d'en-tête Adc.h ; son ID de service est 0x06 [SWS_Adc_91002]. Les codes d'erreur spécifiques, les contextes d'appel ou les notifications DET/DEM ne sont pas inclus dans le présent extrait de spécification.

La fonction Adc_EnableGroupNotification sert à activer le mécanisme de notification pour un groupe de canaux ADC demandé [SWS_Adc_91003]. La déclaration de cette interface est mise à la disposition des utilisateurs via le fichier d'en-tête Adc.h [SWS_Adc_91003].

Seul paramètre d'entrée, Group de type de données Adc_GroupType est transmis, définissant l'ID numérique du groupe de canaux ADC demandé [SWS_Adc_91003]. La fonction ne comporte aucun paramètre d'entrée/sortie ni de sortie, et ne renvoie aucune valeur de retour (void) [SWS_Adc_91003]. Le service est référencé sous l'ID de service 0x07 et présente une sémantique d'exécution asynchrone [SWS_Adc_91003].

En matière de comportement de concurrence, Adc_EnableGroupNotification est spécifiée comme réentrante [SWS_Adc_91003]. Plusieurs appels parallèles sont donc autorisés. La classification asynchrone de l'exécution devrait signifier que l'activation de la notification de groupe est mise en attente dans le pilote ou mise en œuvre en arrière-plan, sans bloquer le contexte appelant pendant le déroulement [SWS_Adc_91003]. Question Q-bae8fba7810fa269 (ouverte)

Le présent extrait de spécification n'établit aucune disposition supplémentaire concernant des erreurs spécifiques de développement ou de production (DET ou DEM), ni des conditions d'appel ou contextes de tâches exacts.

La fonction de service synchrone Adc_SetPowerState fait passer le module ADC dans un état d'énergie préalablement préparé, sélectionné parmi un ensemble préconfiguré [SWS_Adc_00475].

Utilisation

La fonction est disponible via l'en-tête Adc.h et possède l'ID de service 0x10 [SWS_Adc_00475]. Elle ne prend aucun paramètre d'entrée, mais transmet le résultat via le paramètre de sortie Result de type Adc_PowerStateRequestResultType* [SWS_Adc_00475]. En cas d'activation réussie de l'état d'énergie, la fonction renvoie E_OK et signale via Result l'état ADC_SERVICE_ACCEPTED [SWS_Adc_00475].

Gestion des erreurs

Si la demande est rejetée, l'appel fournit la valeur de retour E_NOT_OK [SWS_Adc_00475]. Le module différencie alors dans le paramètre Result trois causes d'erreur spécifiques :

• ADC_NOT_INIT : le module ADC n'est pas encore initialisé au moment de l'appel [SWS_Adc_00475].
• ADC_SEQUENCE_ERROR : l'ordre des appels d'API est incorrect [SWS_Adc_00475].
• ADC_HW_FAILURE : une erreur matérielle survenue empêche le passage à l'état demandé [SWS_Adc_00475].

Concurrence et restrictions

Adc_SetPowerState est non réentrante (Non Reentrant) et bloque l'appelant jusqu'à l'adoption synchrone de l'état [SWS_Adc_00475]. Selon l'interprétation retenue, une étape préalable de préparation à l'état cible doit obligatoirement avoir été exécutée avant l'appel, dans la mesure où la fonction requiert explicitement un état déjà préparé et rejette les erreurs d'ordonnancement par ADC_SEQUENCE_ERROR [SWS_Adc_00475].

Utilisation et contexte d'appel

La fonction synchrone Adc_PreparePowerState déclenche le processus de préparation nécessaire pour faire passer le module matériel ADC dans un état de puissance demandé [SWS_Adc_00478]. Sont transmis comme paramètres l'état cible souhaité PowerState ainsi qu'un pointeur Result via lequel l'état de la requête est renvoyé [SWS_Adc_00478]. La valeur de retour signale par E_OK que le processus de préparation a été démarré, ou par E_NOT_OK que le service a été rejeté [SWS_Adc_00478].

Traitement des résultats et des erreurs

En cas de succès (E_OK), le paramètre de sortie Result fournit la valeur d'état ADC_SERVICE_ACCEPTED [SWS_Adc_00478]. Si le service a été rejeté avec E_NOT_OK, Result précise la cause exacte [SWS_Adc_00478] :

• ADC_NOT_INIT : le module ADC n'est pas encore initialisé [SWS_Adc_00478].
• ADC_SEQUENCE_ERROR : séquence d'appel non valide, car l'état actuel correspond déjà à l'état cible [SWS_Adc_00478].
• ADC_POWER_STATE_NOT_SUPP : l'état de puissance demandé n'est pas pris en charge par le module [SWS_Adc_00478].
• ADC_TRANS_NOT_POSSIBLE : une transition directe n'est pas possible ou le périphérique matériel est encore occupé [SWS_Adc_00478].

Concurrence et interaction

La fonction est spécifiée comme non réentrante [SWS_Adc_00478]. Par conséquent, l'appelant doit s'assurer que les appels s'effectuent séquentiellement et sans chevauchement. Les appelants devraient devoir achever ou interrompre au préalable les conversions en cours, car un périphérique matériel actif entraîne un rejet. Question Q-210c59a46a90d781 (ouverte) Après une préparation réussie par Adc_PreparePowerState, les actions consécutives sans effet immédiat visant à finaliser la transition d'état sont exécutées via une API subséquente associée [SWS_Adc_00499].

Utilisation et contexte d'appel

La fonction principale Adc_Main_PowerTransitionManager sert à la surveillance cyclique et au déroulement des transitions d'état d'alimentation dans le module ADC [SWS_Adc_00479]. Elle possède la signature void Adc_Main_PowerTransitionManager(void), ne prend aucun paramètre d'entrée et ne renvoie aucune valeur [SWS_Adc_00479]. La fonction est appelée cycliquement et déclarée via l'en-tête SchM_Adc.h [SWS_Adc_00479]. L'appel devrait donc typiquement s'effectuer dans le contexte de tâche cyclique du planificateur BSW (SchM). Question Q-4fc01e5bed5b3b57 (ouverte)

Surveillance d'état et séquences asynchrones

Pendant l'exécution cyclique, la fonction vérifie en continu la disponibilité opérationnelle du module pour l'état d'alimentation demandé [SWS_Adc_00479]. Dès que la disponibilité du module est constatée, elle émet les rappels de notification IoHwAb_Adc_NotifyReadyForPowerState<Mode> référencés via le paramètre de configuration AdcPowerStateReadyCbkRef [SWS_Adc_00479]. Toutes les opérations asynchrones nécessaires à l'atteinte de l'état d'alimentation cible peuvent être traitées en arrière-plan dans le contexte d'exécution de Adc_Main_PowerTransitionManager [SWS_Adc_00498].

Gestion des erreurs et conditions limites

Si un état d'alimentation demandé ne peut pas être atteint directement à partir de l'état d'alimentation actuel, l'API signale l'erreur d'exécution ADC_E_TRANSITION_NOT_POSSIBLE [SWS_Adc_00498]. L'externalisation des processus de transition plus longs dans cette fonction gestionnaire cyclique évite de bloquer les appelants de niveau supérieur pendant que le module ADC finalise le changement d'état en arrière-plan [SWS_Adc_00498].

La fonction IoHwAb_Adc_NotifyReadyForPower sert d'interface de notification de l'abstraction matérielle d'E/S et est appelée par le pilote ADC dès que la préparation pour un état de puissance demandé dans le mode <#Mode> est terminée [SWS_Adc_00480]. La déclaration de cette interface est fournie par le fichier d'en-tête IoHwAb_Adc.h [SWS_Adc_00480].

Contexte d'appel et sémantique

Conformément à la spécification, les conditions-cadres suivantes s'appliquent à l'appel [SWS_Adc_00480] :

• Paramètres et valeur de retour : la fonction ne possède aucun paramètre d'entrée, de sortie ni d'entrée/sortie et ne renvoie aucune valeur de retour (void) [SWS_Adc_00480].
• Synchronicité : le comportement d'exécution est défini comme synchrone [SWS_Adc_00480].
• Réentrance : la fonction est classée comme non réentrante (Non Reentrant) [SWS_Adc_00480]. Les appelants doivent par conséquent s'assurer que les appels sont séquentiels et ne se chevauchent pas de manière concurrente.

Interaction et gestion des erreurs

Aucun code d'erreur ni notification destinée à DET ou DEM ne figure dans les données de spécification [SWS_Adc_00480]. L'indication de syntaxe IoHwAb_Adc_NotifyReadyForPowerState<#Mode> suggère que l'identifiant est généré spécifiquement en fonction du mode de puissance configuré. Question Q-9e9c969f8a41d0de (ouverte) La fonction agit probablement en tant que callback du pilote afin d'indiquer à la gestion de puissance de niveau supérieur l'état de préparation pour le changement.

Le type énuméré Adc_StatusType représente, selon [SWS_Adc_00513], l'état de conversion actuel d'un groupe de canaux ADC demandé et est mis à disposition via l'en-tête Adc.h.

Les valeurs d'énumération reflètent la progression de la conversion analogique-numérique ainsi que la disponibilité des résultats [SWS_Adc_00513] :

• ADC_IDLE (0x00) : la conversion du groupe indiqué n'a pas encore été démarrée ; aucun résultat de mesure n'est disponible [SWS_Adc_00513].
• ADC_BUSY (0x01) : la conversion du groupe a démarré et est actuellement en cours ; aucun résultat n'est disponible jusqu'à présent [SWS_Adc_00513].
• ADC_COMPLETED (0x02) : un cycle de conversion (qui n'est pas le cycle final) du groupe est achevé ; un résultat est disponible pour tous les canaux du groupe [SWS_Adc_00513].
• ADC_STREAM_COMPLETED (0x03) : le tampon de résultats est entièrement rempli ; le nombre requis d'échantillons est disponible pour chaque canal du groupe sélectionné [SWS_Adc_00513].

Dans les applications, ce type sert généralement à interroger ou évaluer la progression du groupe afin de déterminer si des résultats peuvent déjà être lus ou si d'autres échantillonnages sont en attente.

Le type énuméré Adc_GroupConvModeType sert à configurer le mode de conversion d'un groupe de canaux ADC et est déclaré par le biais du fichier d'en-tête Adc.h [SWS_Adc_00515]. Ce type définit si les canaux d'un groupe sont convertis une seule fois ou de façon répétée après l'événement de déclenchement configuré [SWS_Adc_00515].

Deux modes sont disponibles pour la configuration [SWS_Adc_00515] :

• ADC_CONV_MODE_ONESHOT (0x00) : exécute exactement une conversion de chaque canal du groupe de canaux ADC après l'événement de déclenchement configuré [SWS_Adc_00515]. Si un déclencheur logiciel a été configuré comme source de déclenchement, une conversion démarrée peut être arrêtée via un appel d'API logicielle [SWS_Adc_00515]. En revanche, si une source de déclenchement matériel est assignée, une conversion ponctuelle (one-shot) démarrée peut être suspendue par la désactivation de l'événement de déclenchement, sous réserve de prise en charge par le matériel [SWS_Adc_00515].
• ADC_CONV_MODE_CONTINUOUS (0x01) : effectue en continu des conversions répétées de chaque canal au sein du groupe de canaux [SWS_Adc_00515]. Ce mode continu est exclusivement disponible pour les groupes disposant d'une source de déclenchement logiciel [SWS_Adc_00515]. Un cycle de conversion continu déjà démarré peut être interrompu à tout moment au moyen d'un appel d'API logicielle [SWS_Adc_00515].

En ce qui concerne les restrictions, il convient de noter que ADC_CONV_MODE_CONTINUOUS n'est autorisé qu'avec un déclenchement logiciel et ne peut pas être combiné avec des sources de déclenchement matériel [SWS_Adc_00515]. Avec les déclencheurs logiciels, l'arrêt des conversions en cours requiert un appel d'API logicielle dédié, tandis que les séquences ponctuelles à déclenchement matériel exigent la désactivation de l'événement de déclenchement [SWS_Adc_00515].

Le type d'énumération Adc_StreamBufferModeType sert à configurer le comportement de tampon en mode d'accès streaming du pilote ADC et est disponible via le fichier d'en-tête Adc.h [SWS_Adc_00519].

Le type définit deux modes de fonctionnement spécifiques pour la gestion de tampon lors de conversions en streaming [SWS_Adc_00519] :

• ADC_STREAM_BUFFER_LINEAR (valeur 0x00) : le pilote ADC met automatiquement fin à la conversion dès que le tampon de flux est plein ou que le nombre défini d'échantillons est atteint [SWS_Adc_00519].
• ADC_STREAM_BUFFER_CIRCULAR (valeur 0x01) : le pilote ADC poursuit la conversion même après avoir atteint la capacité totale du tampon, en revenant au début du tampon et en l'écrasant de manière circulaire [SWS_Adc_00519].

Les couches d'intégration et les logiciels d'application doivent adapter le comportement de tampon à la stratégie de traitement respective : alors que ADC_STREAM_BUFFER_LINEAR est prévu pour des séries de mesures autonomes avec une taille d'échantillon fixe, ADC_STREAM_BUFFER_CIRCULAR exige vraisemblablement une surveillance continue du tampon ou un prélèvement rapide des données afin d'éviter une perte de données inaperçue due à l'écrasement automatique [SWS_Adc_00519]. Question Q-23b411e5e6c50591 (ouverte)

Le type d'énumération Adc_GroupAccessModeType sert à configurer le mode d'accès aux résultats de conversion d'un groupe de canaux ADC conformément à [SWS_Adc_00528]. La définition du type est mise à disposition via le fichier d'en-tête Adc.h et détermine la manière dont les résultats sont stockés en mémoire.

Pour la configuration du mode d'accès du groupe, deux valeurs sont définies dans la spécification [SWS_Adc_00528] :

• ADC_ACCESS_MODE_SINGLE (valeur 0x00) : configure le mode d'accès à valeur unique (Single value access mode) pour le groupe concerné.
• ADC_ACCESS_MODE_STREAMING (valeur 0x01) : configure le mode d'accès en streaming (Streaming access mode) pour le groupe concerné.

Ce type est utilisé lors de la configuration du pilote ADC pour contrôler le comportement d'accès aux tampons des résultats de conversion [SWS_Adc_00528]. Interprétation : alors que le mode valeur unique est vraisemblablement conçu pour fournir une seule valeur de résultat actuelle par canal de groupe, le mode streaming est probablement prévu pour des séries de mesures plus continues comportant plusieurs valeurs de tampon. Question Q-8a933cffcd1132ef (ouverte)

Puisqu'il s'agit d'un type de configuration pur, l'exigence ne définit pas de codes d'erreur propres, de valeurs de retour ou de messages DET/DEM pour ce type [SWS_Adc_00528].

Utilisation et plage de valeurs

Le type énuméré Adc_ResultAlignmentType est fourni via le fichier d'en-tête Adc.h et sert, dans le module Adc, à définir l'alignement des valeurs brutes d'ADC dans le tampon de résultat [SWS_Adc_00525]. Il constitue l'interface standardisée pour configurer le stockage dans le tampon du pilote [SWS_Adc_00525]. En tant que type de données pur, il ne possède pas de paramètres de fonction propres, de valeurs de retour ou de sémantique asynchrone [SWS_Adc_00525].

La plage de valeurs de l'énumération comprend exactement deux valeurs selon la spécification [SWS_Adc_00525] :

• ADC_ALIGN_LEFT (valeur numérique 0x00) : configure un alignement à gauche des résultats de conversion dans le tampon [SWS_Adc_00525].
• ADC_ALIGN_RIGHT (valeur numérique 0x01) : configure un alignement à droite des résultats de conversion dans le tampon [SWS_Adc_00525].

Signification et conditions aux limites

La valeur choisie détermine les positions de bits de la zone de tampon où sont stockées les données brutes après une conversion [SWS_Adc_00525]. Cela permet de définir si les bits de données significatifs se situent alignés à gauche ou à droite en mémoire [SWS_Adc_00525]. Interprétation : la fixation d'un alignement à gauche ou à droite devrait être particulièrement pertinente lorsque la résolution matérielle du convertisseur analogique-numérique est inférieure à la largeur d'élément de la mémoire tampon allouée. Les composants logiciels en aval doivent tenir compte de l'alignement configuré afin de pouvoir lire les valeurs brutes sans erreurs de calcul ou de décalage de bits. Question Q-54221124172a3d87 (ouverte)

Il n'existe pas de codes d'erreur spécifiques, de messages DET ou DEM pour cette énumération [SWS_Adc_00525].

Le type énuméré Adc_PowerStateType définit dans AUTOSAR Classic l'état d'alimentation du pilote ADC [SWS_Adc_00526]. Il est utilisé dans le pilote pour représenter soit l'état de fonctionnement actuellement adopté par le module, soit pour spécifier un nouvel état cible à atteindre pour la gestion de l'énergie [SWS_Adc_00526]. La déclaration de ce type de données est mise à disposition via l'en-tête Adc.h [SWS_Adc_00526].

Pour les différents états de l'énumération, la spécification établit un ordre hiérarchique concernant la consommation de puissance [SWS_Adc_00526] :

• ADC_FULL_POWER (valeur numérique 0) : désigne le mode de fonctionnement et de pleine fonctionnalité du pilote ADC sans restrictions de courant [SWS_Adc_00526].
• Plage de valeurs de 1 à 255 : représente des modes d'économie d'énergie optionnels avec une réduction progressive de la consommation de puissance [SWS_Adc_00526].

En ce qui concerne l'interaction et l'intégration dans l'environnement système, l'interprétation suivante s'applique : le type devrait principalement servir de paramètre de transmission dans les fonctions de commande pour les transitions d'état d'alimentation (Power-State), ainsi que pour le retour d'état vers des modules de niveau supérieur tels que la gestion d'état du BSW ou de l'ECU. Question Q-e4f964bd79ad550c (ouverte) Puisqu'il s'agit d'une définition de type de données élémentaire, les propriétés spécifiques telles que les contextes d'appel, les exigences de réentrance, la sémantique synchrone ou asynchrone, ainsi que les erreurs d'exécution et les notifications DET ne sont définies que dans les API de pilote associées et ne font pas partie de cette description de type [SWS_Adc_00526].

Le type énuméré Adc_PowerStateRequestResultType définit les valeurs de retour pour les demandes de transition d'état au sein de la gestion de puissance du pilote ADC et est mis à disposition via le fichier d'en-tête Adc.h [SWS_Adc_00527].

Les valeurs du type représentent le succès ou des causes d'erreur spécifiques d'un changement d'état de puissance demandé [SWS_Adc_00527] :

• ADC_SERVICE_ACCEPTED (0) : le passage à l'état souhaité a été exécuté avec succès [SWS_Adc_00527].
• ADC_NOT_INIT (1) : l'appel a échoué car le module ADC n'est pas encore initialisé [SWS_Adc_00527].
• ADC_SEQUENCE_ERROR (2) : l'ordre des appels aux API est incorrect [SWS_Adc_00527].
• ADC_HW_FAILURE (3) : une erreur matérielle empêche le passage à l'état requis [SWS_Adc_00527].
• ADC_POWER_STATE_NOT_SUPP (4) : l'état de puissance requis n'est pas pris en charge par le module ADC [SWS_Adc_00527].
• ADC_TRANS_NOT_POSSIBLE (5) : une transition directe de l'état actuel vers l'état souhaité n'est pas possible ou le périphérique matériel est encore occupé [SWS_Adc_00527].

Les appelants doivent évaluer la valeur de retour pour faire la distinction entre une exécution régulière et des conditions d'erreur telles qu'une séquence incorrecte, une absence d'initialisation du module ou des conflits matériels [SWS_Adc_00527].