ADC Driver (Adc)

Die synchrone Funktion Adc_Init (Service-ID 0x00) dient der initialen Konfiguration und Inbetriebnahme aller ADC-Hardware-Einheiten sowie des ADC-Treibers gemäß [SWS_Adc_00365]. Die Schnittstelle wird über die Header-Datei Adc.h bereitgestellt und besitzt keinen Rückgabewert.

Parameter und Konfigurationsvarianten

Die Übergabe der Konfigurationsdaten erfolgt über den Zeigerparameter ConfigPtr vom Typ const Adc_ConfigType* [SWS_Adc_00365]. Das geforderte Argument hängt von der gewählten Build-Variante ab:

• Bei Verwendung der Post-Build-Konfiguration (Variant PB) muss ConfigPtr auf die entsprechende Datenstruktur mit den Initialisierungswerten verweisen.
• Wird die Vorkompilierungsvariante (Variant PC) eingesetzt, verlangt die Schnittstelle explizit die Übergabe eines NULL_PTR [SWS_Adc_00365].

Nebenläufigkeit und Systemintegration

Die Funktion Adc_Init ist als nicht reentrant (Non Reentrant) spezifiziert [SWS_Adc_00365]. Interpretation: Da Hardware-Einheiten global konfiguriert werden und keine Reentranz vorliegt, dürfte der Aufruf typischerweise zentral während der Systeminitialisierung erfolgen, bevor andere Modulfunktionen oder Wandlungen angestoßen werden. Frage Q-a82e9204ae7a5ab7 (offen)

Hinsichtlich des Energie-Managements besteht eine direkte Kopplung zu verwandten Anforderungen: Falls im Betrieb der normale Energiezustand (normal Power State) angefordert wird, muss die entsprechende API auf Konfigurationsparameter zurückgreifen, die sich in denselben Containern wie die Initialisierungsparameter von Adc_Init befinden [SWS_Adc_00483].

Die Funktion Adc_SetupResultBuffer initialisiert den ADC-Treiber mit der Startadresse eines gruppenspezifischen Puffers zur Speicherung von Konvertierungsergebnissen [SWS_Adc_91000]. Dieser Aufruf ist nach einem Reset zwingend erforderlich, bevor eine Gruppenkonvertierung gestartet werden kann [SWS_Adc_91000].

Parameter und Aufrufkontext

• Group: Numerische Kennung der angeforderten ADC-Kanalgruppe [SWS_Adc_91000].
• DataBufferPtr: Zeiger auf den Datenpuffer (Typ Adc_ValueGroupType*), in dem die Ergebnisse abgelegt werden [SWS_Adc_91000].

Die Funktion ist als reentrant und asynchron deklariert und steht über die Header-Datei Adc.h (Service-ID 0x0c) zur Verfügung [SWS_Adc_91000].

Rückgabewerte und Fehlerbehandlung

Der Rückgabetyp ist Std_ReturnType [SWS_Adc_91000]:

• E_OK: Der Zeiger auf den Ergebnis-Puffer wurde erfolgreich initialisiert [SWS_Adc_91000].
• E_NOT_OK: Die Operation ist fehlgeschlagen oder es ist ein Entwicklungsfehler aufgetreten [SWS_Adc_91000].

Pflichten der Applikation

Die aufrufende Applikation muss gewährleisten, dass der Puffer, auf den DataBufferPtr verweist, ausreichend Speicherplatz für sämtliche Konvertierungsergebnisse der angegebenen Kanalgruppe bereitstellt [SWS_Adc_91000].

Die Funktion Adc_DeInit dient der Deinitialisierung des ADC-Treibers und überführt alle zugehörigen ADC-Hardware-Einheiten in einen Zustand, der dem Zustand unmittelbar nach einem Power-on-Reset vergleichbar ist [SWS_Adc_00366]. Sie stellt damit den Ausgangszustand der Hardware vor einer erneuten Initialisierung wieder her.

Aufruf und Schnittstelle

Die Funktion ist in der Header-Datei Adc.h deklariert und besitzt die Service-ID 0x01 [SWS_Adc_00366]. Der Aufruf erfolgt synchron (Synchronous) und erfordert keinerlei Parameter (weder In, InOut noch Out); ein Rückgabewert wird ebenfalls nicht bereitgestellt (Signatur void Adc_DeInit(void)) [SWS_Adc_00366]. Es werden dabei weder Eingabeparameter noch Rückgabewerte ausgewertet oder erzeugt. Aufgrund der synchronen Semantik blockiert die Ausführung den Aufrufer, bis das Zurücksetzen aller Einheiten abgeschlossen ist [SWS_Adc_00366].

Nebenläufigkeit und Einschränkungen

Hinsichtlich der Nebenläufigkeit ist die Funktion als nicht reentrant (Non Reentrant) spezifiziert [SWS_Adc_00366]. Daraus ergibt sich die Interpretation: Gleichzeitige oder überlappende Aufrufe von Adc_DeInit aus mehreren Tasks oder unterschiedlichen Software-Schichten sind nicht zulässig und müssen vom Aufrufer koordiniert und vermieden werden.

Da Adc_DeInit alle ADC-Hardware-Einheiten vollständig in den Reset-Zustand zurückversetzt [SWS_Adc_00366], dürfte vor dem Aufruf sicherzustellen sein, dass keine Mess- oder Wandlungsprozesse mehr aktiv sind, um undefiniertes Verhalten der Hardware zu verhindern. Frage Q-15bfa2b822826786 (offen)

Verwendung

Die Funktion Adc_StartGroupConversion startet die Wandlung aller Kanäle der übergebenen ADC-Kanalgruppe gemäß [SWS_Adc_00367]. Als Parameter wird die numerische Gruppen-ID Group vom Typ Adc_GroupType übergeben. Die Funktion hat keinen Rückgabewert (void) und arbeitet asynchron ([SWS_Adc_00367]).

Nebenläufigkeit und Einschränkungen

Laut Spezifikation ist der Dienst reentrant eingestuft ([SWS_Adc_00367]). Interpretation: Dies dürfte bedeuten, dass die Funktion nebenläufig für unterschiedliche Kanalgruppen aufgerufen werden kann. Frage Q-8283232f222f7b0a (offen) Da der Start asynchron erfolgt, kehrt der Aufruf vor Abschluss der eigentlichen Wandlung zurück.

Fehlerbehandlung und Zusammenspiel

Der Dienst ist über den Header Adc.h verfügbar und hat die Service-ID 0x02 ([SWS_Adc_00367]). Spezifische DET- oder DEM-Fehlercodes sind im vorliegenden Payload nicht dokumentiert.

Die synchrone Funktion Adc_StopGroupConversion beendet die laufende Konvertierung einer angeforderten ADC-Kanalgruppe [SWS_Adc_00368]. Die Schnittstelle ist im Header Adc.h deklariert und unter der Service-ID 0x03 spezifiziert [SWS_Adc_00368].

Als einziger Parameter wird der Eingangswert Group vom Typ Adc_GroupType übergeben, welcher die numerische ID der jeweiligen ADC-Kanalgruppe repräsentiert [SWS_Adc_00368]. Der Aufruf besitzt keinen Rückgabewert (void) und verwendet weder Ein-/Ausgangs- noch reine Ausgangsparameter [SWS_Adc_00368].

Hinsichtlich des Nebenläufigkeitsverhaltens ist der Dienst als reentrant eingestuft und weist eine synchrone Ausführungssemantik auf [SWS_Adc_00368]. Parallele Aufrufe der Schnittstelle sind somit zulässig. Das synchrone Verhalten impliziert, dass die Operation unmittelbar mit dem Funktionsaufruf abgeschlossen wird [SWS_Adc_00368].

Interpretation: Ein Aufruf dürfte funktional voraussetzen, dass für die betreffende Gruppe zuvor eine Konvertierung initiiert wurde, um das Stoppen durchführen zu können. Frage Q-644ca5344ab849b0 (offen) Spezifische Fehlercodes, Rückgabewerte zur Fehleranzeige oder Meldungen an Entwicklungsendgeräte (DET/DEM) sind im vorliegenden Spezifikationsauszug für diesen Dienst nicht ausgewiesen [SWS_Adc_00368].

Die synchrone Funktion Adc_ReadGroup dient dem Auslesen der Konvertierungsergebnisse einer ADC-Kanalgruppe aus der zuletzt abgeschlossenen Wandlungsrunde ([SWS_Adc_00369]). Sie ist über die Header-Datei Adc.h verfügbar und besitzt die Service-ID 0x04 ([SWS_Adc_00369]).

Parameter und Pufferlayout

• Group: Numerische Kennung der angeforderten ADC-Kanalgruppe ([SWS_Adc_00369]).
• DataBufferPtr: Zeiger auf den Zielpuffer (Adc_ValueGroupType*), ab dessen Adresse die Wandlungsergebnisse aller Kanäle der Gruppe abgelegt werden ([SWS_Adc_00369]).

Die Speicherung der Kanalwerte erfolgt ab der Zieladresse in aufsteigender Kanalreihenfolge ([SWS_Adc_00369]). Dieses Speicherlayout unterscheidet sich explizit von der Pufferanordnung bei konfiguriertem Streaming-Zugriff ([SWS_Adc_00369]). Interpretation: Der Aufrufer dürfte dafür verantwortlich sein, einen ausreichend dimensionierten Puffer für alle Kanäle der Gruppe bereitzustellen. Frage Q-f22a12a6c7ab0eb3 (offen)

Rückgabewerte und Fehlerbehandlung

Der Rückgabewert vom Typ Std_ReturnType signalisiert den Status der Leseoperation ([SWS_Adc_00369]):

• E_OK: Ergebnisse sind verfügbar und wurden erfolgreich in den Datenpuffer geschrieben ([SWS_Adc_00369]).
• E_NOT_OK: Es sind keine Ergebnisse verfügbar oder es ist ein Entwicklungsfehler aufgetreten ([SWS_Adc_00369]).

Nebenläufigkeit

Die Funktion ist als reentrant spezifiziert ([SWS_Adc_00369]). Sie kann somit parallel ausgeführt werden, solange für gleichzeitige Zugriffe getrennte Pufferbereiche verwendet werden.

Verwendung und Parameter

Die Funktion Adc_EnableHardwareTrigger aktiviert den Hardware-Trigger für eine konfigurierte ADC-Kanalgruppe [SWS_Adc_91001]. Sie ist als Dienst mit der Service-ID 0x05 im Modul Adc definiert und über die Header-Datei Adc.h verfügbar [SWS_Adc_91001].

• Eingangsparameter: Über den Parameter Group vom Typ Adc_GroupType wird die numerische ID der gewünschten ADC-Kanalgruppe übergeben [SWS_Adc_91001]. Zusätzliche Ein-/Ausgabe- oder Ausgabeparameter existieren nicht [SWS_Adc_91001].
• Rückgabewert: Die Schnittstelle liefert keinen Rückgabewert (void) [SWS_Adc_91001].
• Asynchrone Semantik: Das Ausführungsverhalten ist als asynchron festgelegt [SWS_Adc_91001]. Der Aufruf schaltet die Triggerung frei, während die tatsächliche Wandlung der Kanäle erst durch nachfolgende Hardware-Ereignisse angestoßen wird.

Nebenläufigkeit

Der Treiber spezifiziert Adc_EnableHardwareTrigger als reentrant [SWS_Adc_91001]. Interpretation: Die Reentranz dürfte sich in erster Linie auf den gleichzeitigen Aufruf mit disjunkten Kanalgruppen beziehen, da der Hardware-Trigger pro Kanalgruppe aktiviert wird. Frage Q-5750576df9f0284d (offen)

Die Funktion Adc_DisableHardwareTrigger dient dazu, die Hardware-Triggerung für eine angeforderte ADC-Kanalgruppe zu deaktivieren [SWS_Adc_91002].

Verwendung und Semantik

• Parameter: Übergeben wird der Parameter Group vom Typ Adc_GroupType, welcher die numerische ID der gewünschten ADC-Kanalgruppe spezifiziert [SWS_Adc_91002].
• Rückgabewert: Die Funktion besitzt keinen Rückgabewert (void) [SWS_Adc_91002].
• Ausführungsverhalten: Der Aufruf wird als asynchron eingestuft (Sync/Async: Asynchronous) [SWS_Adc_91002]. Dies bedeutet vermutlich, dass das tatsächliche Stoppen oder Entkoppeln des Hardware-Ereignisses hardwareseitig zeitversetzt wirksam werden kann. Frage Q-b0e613163b254242 (offen)

Nebenläufigkeit und Einbindung

Die Schnittstelle ist als reentrant deklariert (Reentrancy: Reentrant) und wird über die Header-Datei Adc.h bereitgestellt; ihre Service-ID lautet 0x06 [SWS_Adc_91002]. Spezifische Fehlercodes, Aufrufkontexte oder DET-/DEM-Meldungen sind im vorliegenden Spezifikationsauszug nicht enthalten.

Die Funktion Adc_EnableGroupNotification dient dazu, den Benachrichtigungsmechanismus für eine angeforderte ADC-Kanalgruppe zu aktivieren [SWS_Adc_91003]. Die Deklaration dieser Schnittstelle wird über die Header-Datei Adc.h für Anwender bereitgestellt [SWS_Adc_91003].

Als einziger Eingabeparameter wird Group vom Datentyp Adc_GroupType übergeben, welcher die numerische ID der angeforderten ADC-Kanalgruppe bestimmt [SWS_Adc_91003]. Die Funktion besitzt weder Ein-/Ausgabeparameter noch Ausgabeparameter und liefert keinen Rückgabewert (void) zurück [SWS_Adc_91003]. Der Dienst ist unter der Service-ID 0x07 geführt und weist eine asynchrone Ausführungssemantik auf [SWS_Adc_91003].

Bezüglich des Nebenläufigkeitsverhaltens ist Adc_EnableGroupNotification als reentrant spezifiziert [SWS_Adc_91003]. Mehrere parallele Aufrufe sind demnach zulässig. Die asynchrone Einstufung der Ausführung dürfte bedeuten, dass die Aktivierung der Gruppenbenachrichtigung im Treiber vorgemerkt oder im Hintergrund umgesetzt wird, ohne den aufrufenden Kontext während der Abwicklung zu blockieren [SWS_Adc_91003]. Frage Q-bae8fba7810fa269 (offen)

Zu spezifischen Entwicklungs- oder Produktionsfehlern (DET oder DEM) sowie zu exakten Aufrufbedingungen oder Task-Kontexten trifft der vorliegende Spezifikationsauszug keine weiteren Festlegungen.

Die im Header Adc.h deklarierte Funktion Adc_DisableGroupNotification dient im ADC-Treiber dazu, den Benachrichtigungsmechanismus für eine angeforderte ADC-Kanalgruppe gezielt abzuschalten [SWS_Adc_91004]. Der Dienst besitzt die Service-ID 0x08 und ist mit der Signatur void Adc_DisableGroupNotification (Adc_GroupType Group) spezifiziert [SWS_Adc_91004].

Parameter und Schnittstelle

Für die Ausführung der Funktion ist die Übergabe eines einzelnen Eingangsparameters festgelegt:

• Group: Übergibt als numerische Kennung vom Typ Adc_GroupType die eindeutige ID der gewünschten ADC-Kanalgruppe, deren Benachrichtigung deaktiviert werden soll [SWS_Adc_91004].

Die Funktion liefert keinen Rückgabewert (void) an den Aufrufer zurück [SWS_Adc_91004]. Zudem werden laut Spezifikation weder kombinierte Ein-/Ausgabeparameter (inout) noch reine Ausgabeparameter (out) verwendet [SWS_Adc_91004].

Ausführungsverhalten und Nebenläufigkeit

Hinsichtlich des Nebenläufigkeitsverhaltens ist Adc_DisableGroupNotification als reentrant eingestuft [SWS_Adc_91004]. Dies gestattet grundsätzlich den parallelen oder unterbrechenden Aufruf des Dienstes durch verschiedene Programmkontexte [SWS_Adc_91004].

Bezüglich der zeitlichen Synchronisation ist die Funktion als asynchron klassifiziert [SWS_Adc_91004]. Interpretation: Da das Zeitverhalten explizit als asynchron deklariert ist, dürfte das Abschalten des Benachrichtigungsmechanismus treiberintern oder in der ADC-Hardware im Hintergrund erfolgen, ohne dass der aufrufende Kontext bis zum vollständigen Abschluss blockiert wird. Frage Q-a1a30a254aa96655 (offen)

Die synchrone Service-Funktion Adc_SetPowerState versetzt das ADC-Modul in einen zuvor vorbereiteten Energiezustand, der aus einer vorkonfigurierten Menge ausgewählt wurde [SWS_Adc_00475].

Verwendung

Die Funktion ist über den Header Adc.h verfügbar und besitzt die Service-ID 0x10 [SWS_Adc_00475]. Sie nimmt keine Eingangsparameter entgegen, sondern übergibt das Ergebnis über den Ausgabeparameter Result vom Typ Adc_PowerStateRequestResultType* [SWS_Adc_00475]. Bei erfolgreicher Aktivierung des Energiezustands gibt die Funktion E_OK zurück und signalisiert über Result den Zustand ADC_SERVICE_ACCEPTED [SWS_Adc_00475].

Fehlerbehandlung

Wird die Anforderung abgewiesen, liefert der Aufruf den Rückgabewert E_NOT_OK [SWS_Adc_00475]. Das Modul differenziert dabei im Parameter Result zwischen drei spezifischen Fehlerursachen:

• ADC_NOT_INIT: Das ADC-Modul ist zum Aufrufzeitpunkt noch nicht initialisiert [SWS_Adc_00475].
• ADC_SEQUENCE_ERROR: Es liegt eine fehlerhafte Reihenfolge der API-Aufrufe vor [SWS_Adc_00475].
• ADC_HW_FAILURE: Ein aufgetretener Hardware-Fehler verhindert das Einnehmen des angeforderten Zustands [SWS_Adc_00475].

Nebenläufigkeit und Einschränkungen

Adc_SetPowerState ist nicht reentrant (Non Reentrant) und blockiert den Aufrufer bis zur synchronen Übernahme des Zustands [SWS_Adc_00475]. Als Interpretation gilt, dass vor dem Aufruf zwingend ein Vorbereitungsschritt für den Zielzustand ausgeführt worden sein muss, da die Funktion explizit einen bereits vorbereiteten Zustand anfordert und Reihenfolgefehler mit ADC_SEQUENCE_ERROR abweist [SWS_Adc_00475].

Verwendung und Aufrufkontext

Die synchrone Funktion Adc_PreparePowerState stößt den erforderlichen Vorbereitungsprozess an, um das ADC-Hardwaremodul in einen angeforderten Energiezustand zu überführen [SWS_Adc_00478]. Als Parameter werden der gewünschte Zielzustand PowerState sowie ein Zeiger Result übergeben, über den der Status der Anforderung zurückgemeldet wird [SWS_Adc_00478]. Der Rückgabewert signalisiert mit E_OK, dass der Vorbereitungsprozess gestartet wurde, oder mit E_NOT_OK, dass der Dienst abgewiesen wurde [SWS_Adc_00478].

Ergebnis- und Fehlerbehandlung

Im Erfolgsfall (E_OK) liefert der Ausgabeparameter Result den Statuswert ADC_SERVICE_ACCEPTED [SWS_Adc_00478]. Wurde der Dienst mit E_NOT_OK abgewiesen, spezifiziert Result die genaue Ursache [SWS_Adc_00478]:

• ADC_NOT_INIT: Das ADC-Modul ist noch nicht initialisiert [SWS_Adc_00478].
• ADC_SEQUENCE_ERROR: Unzulässige Aufrufsequenz, da der aktuelle Zustand bereits dem Zielzustand entspricht [SWS_Adc_00478].
• ADC_POWER_STATE_NOT_SUPP: Der angeforderte Energiezustand wird vom Modul nicht unterstützt [SWS_Adc_00478].
• ADC_TRANS_NOT_POSSIBLE: Ein direkter Übergang ist nicht möglich oder die Hardware-Peripherie ist noch beschäftigt [SWS_Adc_00478].

Nebenläufigkeit und Zusammenspiel

Die Funktion ist als nicht reentrant spezifiziert [SWS_Adc_00478]. Daher muss der Aufrufer sicherstellen, dass Aufrufe sequenziell und ohne Überlappung erfolgen. Aufrufer dürften laufende Wandlungen vorab abschließen oder stoppen müssen, da eine aktive Hardware-Peripherie zur Abweisung führt. Frage Q-210c59a46a90d781 (offen) Nach erfolgreicher Vorbereitung durch Adc_PreparePowerState werden nachfolgende, nicht unmittelbar wirksame Aktionen zur Finalisierung des Zustandsübergangs über eine zugehörige Folge-API ausgeführt [SWS_Adc_00499].

Verwendung und Aufrufkontext

Die Hauptfunktion Adc_Main_PowerTransitionManager dient der zyklischen Überwachung und Abwicklung von Energiezustandsübergängen im ADC-Modul [SWS_Adc_00479]. Sie besitzt die Signatur void Adc_Main_PowerTransitionManager(void), nimmt keine Übergabeparameter entgegen und liefert keinen Rückgabewert zurück [SWS_Adc_00479]. Die Funktion wird zyklisch aufgerufen und über den Header SchM_Adc.h deklariert [SWS_Adc_00479]. Der Aufruf dürfte daher typischerweise im zyklischen Task-Kontext des BSW-Schedulers (SchM) erfolgen. Frage Q-4fc01e5bed5b3b57 (offen)

Zustandsüberwachung und asynchrone Abläufe

Während der zyklischen Ausführung prüft die Funktion fortlaufend die Betriebsbereitschaft des Moduls für den angeforderten Energiezustand [SWS_Adc_00479]. Sobald die Modulbereitschaft festgestellt wird, setzt sie die Benachrichtigungs-Callbacks IoHwAb_Adc_NotifyReadyForPowerState<Mode> ab, welche über den Konfigurationsparameter AdcPowerStateReadyCbkRef referenziert sind [SWS_Adc_00479]. Sämtliche asynchronen Operationen, die zum Erreichen des Ziel-Energiezustands erforderlich sind, können im Hintergrund im Ausführungskontext von Adc_Main_PowerTransitionManager abgearbeitet werden [SWS_Adc_00498].

Fehlerbehandlung und Randbedingungen

Falls ein angeforderter Energiezustand nicht direkt aus dem aktuellen Energiezustand erreicht werden kann, meldet die API den Laufzeitfehler ADC_E_TRANSITION_NOT_POSSIBLE [SWS_Adc_00498]. Durch die Auslagerung längerer Übergangsprozesse in diese zyklische Manager-Funktion werden übergeordnete Aufrufer nicht blockiert, während das ADC-Modul den Zustandswechsel im Hintergrund vervollständigt [SWS_Adc_00498].

Die Funktion IoHwAb_Adc_NotifyReadyForPower dient als Benachrichtigungsschnittstelle der I/O-Hardware-Abstraktion und wird vom ADC-Treiber aufgerufen, sobald die Vorbereitung für einen angeforderten Energiezustand im Modus <#Mode> abgeschlossen ist [SWS_Adc_00480]. Die Deklaration dieser Schnittstelle wird über die Header-Datei IoHwAb_Adc.h bereitgestellt [SWS_Adc_00480].

Aufrufkontext und Semantik

Für den Aufruf gelten gemäß Spezifikation folgende Rahmenbedingungen [SWS_Adc_00480]:

• Parameter und Rückgabewert: Die Funktion besitzt weder Eingabe-, Ausgabe- noch Ein-/Ausgabe-Parameter und liefert keinen Rückgabewert (void) [SWS_Adc_00480].
• Synchronität: Das Ausführungsverhalten ist als synchron definiert [SWS_Adc_00480].
• Reentranz: Die Funktion ist als nicht reentrant (Non Reentrant) eingestuft [SWS_Adc_00480]. Aufrufer müssen daher sicherstellen, dass Aufrufe sequenziell erfolgen und nicht nebenläufig überlagert werden.

Zusammenspiel und Fehlerbehandlung

In den Spezifikationsdaten sind keine Fehlercodes oder Benachrichtigungen an DET oder DEM hinterlegt [SWS_Adc_00480]. Die Syntaxangabe IoHwAb_Adc_NotifyReadyForPowerState<#Mode> dürfte darauf hindeuten, dass der Bezeichner je nach konfiguriertem Power-Modus spezifisch erzeugt wird. Frage Q-9e9c969f8a41d0de (offen) Die Funktion fungiert vermutlich als Callback des Treibers, um dem übergeordneten Power-Management den Bereitschaftszustand für den Wechsel anzuzeigen.

Der Aufzählungstyp Adc_StatusType repräsentiert gemäß [SWS_Adc_00513] den aktuellen Konvertierungsstatus einer angeforderten ADC-Kanalgruppe und wird über den Header Adc.h bereitgestellt.

Die Enumerationswerte spiegeln den Fortschritt der Analog-Digital-Wandlung sowie die Verfügbarkeit von Ergebnissen wider [SWS_Adc_00513]:

• ADC_IDLE (0x00): Die Wandlung der angegebenen Gruppe wurde noch nicht gestartet; es liegen keine Messergebnisse vor [SWS_Adc_00513].
• ADC_BUSY (0x01): Die Konvertierung der Gruppe wurde gestartet und läuft aktuell noch; bisher ist kein Ergebnis verfügbar [SWS_Adc_00513].
• ADC_COMPLETED (0x02): Eine Wandlungsrunde (die nicht die finale ist) der Gruppe wurde abgeschlossen; für alle Kanäle der Gruppe ist ein Ergebnis verfügbar [SWS_Adc_00513].
• ADC_STREAM_COMPLETED (0x03): Der Ergebnis-Puffer ist vollständig gefüllt; für jeden Kanal der gewählten Gruppe steht die geforderte Anzahl an Abtastwerten zur Verfügung [SWS_Adc_00513].

In Anwendungen dient der Typ typischerweise der Abfrage oder Auswertung des Gruppenfortschritts, um festzustellen, ob Ergebnisse bereits ausgelesen werden können oder weitere Abtastungen ausstehen.

Der Aufzählungstyp Adc_GroupConvModeType dient der Konfiguration des Konvertierungsmodus einer ADC-Kanalgruppe und wird über die Header-Datei Adc.h deklariert [SWS_Adc_00515]. Der Typ legt fest, ob die Kanäle einer Gruppe nach dem konfigurierten Auslöseereignis einmalig oder wiederholt umgewandelt werden [SWS_Adc_00515].

Für die Konfiguration stehen zwei Modi zur Verfügung [SWS_Adc_00515]:

• ADC_CONV_MODE_ONESHOT (0x00): Führt nach dem konfigurierten Trigger-Ereignis genau eine Konvertierung jedes Kanals der ADC-Kanalgruppe aus [SWS_Adc_00515]. Wurde als Triggerquelle ein Software-Trigger konfiguriert, kann eine gestartete Konvertierung über einen Software-API-Aufruf gestoppt werden [SWS_Adc_00515]. Ist hingegen eine Hardware-Triggerquelle zugewiesen, lässt sich eine gestartete One-Shot-Konvertierung durch Deaktivieren des Trigger-Ereignisses anhalten, sofern dies durch die Hardware unterstützt wird [SWS_Adc_00515].
• ADC_CONV_MODE_CONTINUOUS (0x01): Führt fortlaufend wiederholte Konvertierungen jedes Kanals innerhalb der Kanalgruppe durch [SWS_Adc_00515]. Dieser kontinuierliche Modus ist ausschließlich für Gruppen mit einer Software-Triggerquelle verfügbar [SWS_Adc_00515]. Ein bereits gestarteter kontinuierlicher Konvertierungslauf kann jederzeit über einen Software-API-Aufruf beendet werden [SWS_Adc_00515].

Hinsichtlich der Restriktionen ist zu beachten, dass ADC_CONV_MODE_CONTINUOUS nur mit Software-Triggerung zulässig ist und nicht mit Hardware-Triggerquellen kombiniert werden kann [SWS_Adc_00515]. Das Stoppen laufender Konvertierungen erfordert bei Software-Triggern einen dedizierten Software-API-Aufruf, während hardwaregetriggerte One-Shot-Abläufe das Abschalten des Trigger-Events erfordern [SWS_Adc_00515].

Der Enumerationstyp Adc_StreamBufferModeType dient zur Konfiguration des Pufferverhaltens im Streaming-Zugriffsmodus des ADC-Treibers und ist über die Header-Datei Adc.h verfügbar [SWS_Adc_00519].

Der Typ definiert zwei spezifische Betriebsmodi für die Pufferverwaltung bei Streaming-Konvertierungen [SWS_Adc_00519]:

• ADC_STREAM_BUFFER_LINEAR (Wert 0x00): Der ADC-Treiber beendet die Wandlung selbsttätig, sobald der Stream-Puffer voll ist bzw. die festgelegte Anzahl an Abtastwerten erreicht wurde [SWS_Adc_00519].
• ADC_STREAM_BUFFER_CIRCULAR (Wert 0x01): Der ADC-Treiber führt die Wandlung auch nach Erreichen der vollen Pufferkapazität fort, indem er an den Anfang des Puffers zurückspringt und diesen zirkulär überschreibt [SWS_Adc_00519].

Integrierende Schichten und Anwendungssoftware müssen das Pufferverhalten auf die jeweilige Verarbeitungsstrategie abstimmen: Während ADC_STREAM_BUFFER_LINEAR für in sich geschlossene Messreihen mit fester Sample-Größe vorgesehen ist, erfordert ADC_STREAM_BUFFER_CIRCULAR vermutlich eine kontinuierliche Pufferüberwachung oder zeitnahe Datenentnahme, um einen unbemerkten Datenverlust durch das automatische Überschreiben zu vermeiden [SWS_Adc_00519]. Frage Q-23b411e5e6c50591 (offen)

Der Enumerationstyp Adc_GroupAccessModeType dient zur Konfiguration des Zugriffsmodus auf die Konvertierungsergebnisse einer ADC-Kanalgruppe gemäß [SWS_Adc_00528]. Die Typdefinition wird über die Header-Datei Adc.h bereitgestellt und legt fest, wie Resultate im Speicher abgelegt werden.

Für die Konfiguration des Gruppen-Zugriffsmodus sind in der Spezifikation zwei Werte definiert [SWS_Adc_00528]:

• ADC_ACCESS_MODE_SINGLE (Wert 0x00): Konfiguriert den Einzelwert-Zugriffsmodus (Single value access mode) für die betreffende Gruppe.
• ADC_ACCESS_MODE_STREAMING (Wert 0x01): Konfiguriert den Streaming-Zugriffsmodus (Streaming access mode) für die betreffende Gruppe.

Der Typ wird bei der Konfiguration des ADC-Treibers verwendet, um das Zugriffsverhalten auf die Puffer der Konvertierungsergebnisse zu steuern [SWS_Adc_00528]. Interpretation: Während der Einzelwertmodus vermutlich für das Bereitstellen eines einzelnen aktuellen Ergebniswerts je Gruppenkanal ausgelegt ist, dürfte der Streaming-Modus für kontinuierlichere Messreihen mit mehreren Pufferwerten konzipiert sein. Frage Q-8a933cffcd1132ef (offen)

Da es sich um einen reinen Konfigurationstyp handelt, definiert die Anforderung keine eigenen Fehlercodes, Rückgabewerte oder DET-/DEM-Meldungen für diesen Typ [SWS_Adc_00528].

Verwendung und Wertebereich

Der Aufzählungstyp Adc_ResultAlignmentType wird über die Header-Datei Adc.h bereitgestellt und dient im Modul Adc zur Festlegung der Ausrichtung von ADC-Rohwerten im Ergebnis-Puffer [SWS_Adc_00525]. Er bildet die standardisierte Schnittstelle zur Konfiguration der Pufferablage des Treibers [SWS_Adc_00525]. Als reiner Datentyp besitzt er keine eigenen Funktionsparameter, Rückgabewerte oder asynchrone Semantik [SWS_Adc_00525].

Der Wertebereich der Enumeration umfasst gemäß Spezifikation genau zwei Ausprägungen [SWS_Adc_00525]:

• ADC_ALIGN_LEFT (numerischer Wert 0x00): Konfiguriert eine linksbündige Ausrichtung der Wandlungsergebnisse im Puffer [SWS_Adc_00525].
• ADC_ALIGN_RIGHT (numerischer Wert 0x01): Konfiguriert eine rechtsbündige Ausrichtung der Wandlungsergebnisse im Puffer [SWS_Adc_00525].

Bedeutung und Randbedingungen

Über den gewählten Wert wird bestimmt, an welchen Bitpositionen des Pufferbereichs die Rohdaten nach einer Konvertierung abgelegt werden [SWS_Adc_00525]. Dadurch wird festgelegt, ob signifikante Datenbits links- oder rechtsbündig im Speicher liegen [SWS_Adc_00525]. Interpretation: Die Festlegung auf Links- oder Rechtsbündigkeit dürfte insbesondere dann relevant sein, wenn die Hardware-Auflösung des Analog-Digital-Wandlers geringer ist als die Elementbreite des zugewiesenen Pufferspeichers. Frage Q-54221124172a3d87 (offen) Nachgelagerte Softwarekomponenten müssen die konfigurierte Ausrichtung berücksichtigen, um Rohwerte ohne Rechen- oder Bitverschiebungsfehler auslesen zu können.

Spezifische Fehlercodes, DET- oder DEM-Meldungen existieren für diese Enumeration nicht [SWS_Adc_00525].

Der Aufzählungstyp Adc_PowerStateType definiert in AUTOSAR Classic den Energiestatus des ADC-Treibers [SWS_Adc_00526]. Er wird im Treiber verwendet, um entweder den aktuell eingenommenen Betriebszustand des Moduls abzubilden oder einen neu anzusteuernden Zielzustand für die Energieverwaltung vorzugeben [SWS_Adc_00526]. Die Deklaration dieses Datentyps wird über den Header Adc.h zur Verfügung gestellt [SWS_Adc_00526].

Für die einzelnen Zustände der Enumeration legt die Spezifikation eine hierarchische Ordnung hinsichtlich der Leistungsaufnahme fest [SWS_Adc_00526]:

• ADC_FULL_POWER (Zahlenwert 0): Bezeichnet den vollen Betriebs- und Funktionsmodus des ADC-Treibers ohne Stromeinschränkungen [SWS_Adc_00526].
• Wertebereich 1 bis 255: Repräsentiert optionale Energiesparmodi mit schrittweise sinkender Leistungsaufnahme [SWS_Adc_00526].

Hinsichtlich des Zusammenspiels und der Einbindung in die Systemumgebung gilt die Interpretation: Der Typ dürfte primär als Übergabeparameter in Steuerungsfunktionen für Power-State-Übergänge sowie zur Statusrückmeldung an übergeordnete Module wie das BSW- oder ECU-State-Management dienen. Frage Q-e4f964bd79ad550c (offen) Weil es sich um eine elementare Datentypdefinition handelt, sind spezifische Eigenschaften wie Aufrufkontexte, Reentranzvorgaben, synchrone oder asynchrone Semantik sowie Laufzeitfehler und DET-Meldungen erst in den zugehörigen Treiber-APIs definiert und nicht Bestandteil dieser Typbeschreibung [SWS_Adc_00526].

Der Aufzählungstyp Adc_PowerStateRequestResultType definiert die Rückgabewerte für Anforderungen von Zustandsübergängen im Power-Management des ADC-Treibers und wird über die Header-Datei Adc.h bereitgestellt [SWS_Adc_00527].

Die Werte des Typs bilden den Erfolg oder spezifische Fehlerursachen eines angeforderten Power-State-Wechsels ab [SWS_Adc_00527]:

• ADC_SERVICE_ACCEPTED (0): Der Wechsel in den gewünschten Zustand wurde erfolgreich ausgeführt [SWS_Adc_00527].
• ADC_NOT_INIT (1): Der Aufruf scheiterte, da das ADC-Modul noch nicht initialisiert ist [SWS_Adc_00527].
• ADC_SEQUENCE_ERROR (2): Es liegt eine fehlerhafte Reihenfolge beim Aufruf der APIs vor [SWS_Adc_00527].
• ADC_HW_FAILURE (3): Ein Hardware-Fehler verhindert den Wechsel in den geforderten Zustand [SWS_Adc_00527].
• ADC_POWER_STATE_NOT_SUPP (4): Der geforderte Power-State wird vom ADC-Modul nicht unterstützt [SWS_Adc_00527].
• ADC_TRANS_NOT_POSSIBLE (5): Ein direkter Übergang vom aktuellen in den gewünschten Zustand ist nicht möglich oder die Hardware-Peripherie ist noch beschäftigt [SWS_Adc_00527].

Aufrufer müssen den Rückgabewert auswerten, um zwischen regulärer Ausführung und fehlerhaften Bedingungen wie falscher Sequenz, fehlender Modulinitialisierung oder Hardwarekonflikten zu unterscheiden [SWS_Adc_00527].