ADC Driver (Adc)

De synchrone functie Adc_Init (service-ID 0x00) dient voor de initiële configuratie en inbedrijfstelling van alle ADC-hardware-eenheden en de ADC-driver conform [SWS_Adc_00365]. De interface wordt aangeboden via het headerbestand Adc.h en heeft geen retourwaarde.

Parameters en configuratievarianten

De configuratiegegevens worden overgedragen via de pointerparameter ConfigPtr van het type const Adc_ConfigType* [SWS_Adc_00365]. Het vereiste argument hangt af van de gekozen buildvariant:

• Bij gebruik van de post-build-configuratie (Variant PB) moet ConfigPtr verwijzen naar de desbetreffende datastructuur met de initialisatiewaarden.
• Wordt de pre-compile-variant (Variant PC) gebruikt, dan vereist de interface expliciet de overdracht van een NULL_PTR [SWS_Adc_00365].

Gelijktijdigheid en systeemintegratie

De functie Adc_Init is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Adc_00365]. Interpretatie: Aangezien hardware-eenheden globaal worden geconfigureerd en er geen sprake is van re-entrantie, vindt de aanroep vermoedelijk typisch centraal plaats tijdens de systeeminitialisatie, voordat andere modulefuncties of conversies worden gestart. Vraag Q-a82e9204ae7a5ab7 (open)

Wat betreft het energiebeheer bestaat er een directe koppeling met verwante eisen: als tijdens bedrijf de normale energietoestand (normal Power State) wordt aangevraagd, moet de desbetreffende API teruggrijpen op configuratieparameters die zich in dezelfde containers bevinden als de initialisatieparameters van Adc_Init [SWS_Adc_00483].

De functie Adc_SetupResultBuffer initialiseert de ADC-driver met het startadres van een groepsspecifieke buffer voor de opslag van conversieresultaten [SWS_Adc_91000]. Deze aanroep is na een reset dwingend vereist voordat een groepsconversie kan worden gestart [SWS_Adc_91000].

Parameters en aanroepcontext

• Group: Numerieke identificatie van de opgevraagde ADC-kanaalgroep [SWS_Adc_91000].
• DataBufferPtr: Pointer naar de databuffer (type Adc_ValueGroupType*) waarin de resultaten worden opgeslagen [SWS_Adc_91000].

De functie is gedeclareerd als re-entrant en asynchroon en is beschikbaar via het headerbestand Adc.h (Service-ID 0x0c) [SWS_Adc_91000].

Retourwaarden en foutafhandeling

Het retourtype is Std_ReturnType [SWS_Adc_91000]:

• E_OK: De pointer naar de resultaatbuffer is succesvol geïnitialiseerd [SWS_Adc_91000].
• E_NOT_OK: De operatie is mislukt of er is een ontwikkelingsfout opgetreden [SWS_Adc_91000].

Verplichtingen van de applicatie

De aanroepende applicatie moet waarborgen dat de buffer waarnaar DataBufferPtr verwijst voldoende geheugenruimte biedt voor alle conversieresultaten van de opgegeven kanaalgroep [SWS_Adc_91000].

De functie Adc_DeInit dient voor de de-initialisatie van de ADC-driver en brengt alle bijbehorende ADC-hardware-eenheden in een toestand die vergelijkbaar is met de toestand direct na een power-on-reset [SWS_Adc_00366]. Deze herstelt daarmee de uitgangstoestand van de hardware vóór een hernieuwde initialisatie.

Aanroep en interface

De functie is gedeclareerd in het headerbestand Adc.h en heeft de service-ID 0x01 [SWS_Adc_00366]. De aanroep vindt synchroon plaats (Synchronous) en vereist geen enkele parameter (noch In, InOut noch Out); een retourwaarde wordt evenmin verstrekt (signatuur void Adc_DeInit(void)) [SWS_Adc_00366]. Er worden daarbij noch invoerparameters noch retourwaarden geëvalueerd of gegenereerd. Vanwege de synchrone semantiek blokkeert de uitvoering de aanroeper totdat het resetten van alle eenheden is voltooid [SWS_Adc_00366].

Gelijktijdigheid en beperkingen

Wat betreft de gelijktijdigheid is de functie gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Adc_00366]. Daaruit volgt de interpretatie: Gelijktijdige of overlappende aanroepen van Adc_DeInit vanuit meerdere taken of verschillende softwarelagen zijn niet toegestaan en moeten door de aanroeper worden gecoördineerd en vermeden.

Aangezien Adc_DeInit alle ADC-hardware-eenheden volledig terugbrengt naar de reset-toestand [SWS_Adc_00366], dient er vóór de aanroep vermoedelijk voor te worden gezorgd dat er geen meet- of conversieprocessen meer actief zijn, om ongedefinieerd gedrag van de hardware te voorkomen. Vraag Q-15bfa2b822826786 (open)

Gebruik

De functie Adc_StartGroupConversion start de conversie van alle kanalen van de meegegeven ADC-kanaalgroep conform [SWS_Adc_00367]. Als parameter wordt het numerieke groeps-ID Group van het type Adc_GroupType doorgegeven. De functie heeft geen retourwaarde (void) en werkt asynchroon ([SWS_Adc_00367]).

Gelijktijdigheid en beperkingen

Volgens de specificatie is de service ingedeeld als re-entrant ([SWS_Adc_00367]). Interpretatie: Dit betekent vermoedelijk dat de functie gelijktijdig kan worden aangeroepen voor verschillende kanaalgroepen. Vraag Q-8283232f222f7b0a (open) Aangezien het starten asynchroon gebeurt, keert de aanroep terug vóór afronding van de eigenlijke conversie.

Foutafhandeling en wisselwerking

De service is beschikbaar via de header Adc.h en heeft de service-ID 0x02 ([SWS_Adc_00367]). Specifieke DET- of DEM-foutcodes zijn in de onderhavige payload niet gedocumenteerd.

De synchrone functie Adc_StopGroupConversion beëindigt de lopende conversie van een aangevraagde ADC-kanaalgroep [SWS_Adc_00368]. De interface is gedeclareerd in de header Adc.h en gespecificeerd onder de service-ID 0x03 [SWS_Adc_00368].

Als enige parameter wordt de invoerwaarde Group van het type Adc_GroupType meegegeven, die het numerieke ID van de desbetreffende ADC-kanaalgroep vertegenwoordigt [SWS_Adc_00368]. De aanroep heeft geen retourwaarde (void) en maakt noch van in-/uitgangs- noch van zuivere uitgangsparameters gebruik [SWS_Adc_00368].

Wat betreft het concurrency-gedrag is de service geclassificeerd als re-entrant en vertoont deze een synchrone uitvoeringssemantiek [SWS_Adc_00368]. Parallelle aanroepen van de interface zijn derhalve toegestaan. Het synchrone gedrag impliceert dat de operatie direct met de functieaanroep wordt voltooid [SWS_Adc_00368].

Interpretatie: Een aanroep vereist functioneel vermoedelijk dat voor de desbetreffende groep vooraf een conversie is geïnitieerd om het stoppen te kunnen uitvoeren. Vraag Q-644ca5344ab849b0 (open) Specifieke foutcodes, retourwaarden voor foutindicatie of meldingen aan ontwikkelingseindapparaten (DET/DEM) zijn in het onderhavige specificatie-uittreksel voor deze service niet aangeduid [SWS_Adc_00368].

De synchrone functie Adc_ReadGroup dient voor het uitlezen van de conversieresultaten van een ADC-kanaalgroep uit de laatst voltooide conversieronde ([SWS_Adc_00369]). Deze is beschikbaar via het headerbestand Adc.h en heeft de service-ID 0x04 ([SWS_Adc_00369]).

Parameters en bufferlayout

• Group: Numerieke identificator van de aangevraagde ADC-kanaalgroep ([SWS_Adc_00369]).
• DataBufferPtr: Pointer naar de doelbuffer (Adc_ValueGroupType*), vanaf welks adres de conversieresultaten van alle kanalen van de groep worden opgeslagen ([SWS_Adc_00369]).

De opslag van de kanaalwaarden vindt plaats vanaf het doeladres in oplopende kanaalvolgorde ([SWS_Adc_00369]). Deze geheugenlayout verschilt expliciet van de bufferindeling bij geconfigureerde streaming-toegang ([SWS_Adc_00369]). Interpretatie: De aanroeper is er vermoedelijk verantwoordelijk voor om een toereikend gedimensioneerde buffer voor alle kanalen van de groep beschikbaar te stellen. Vraag Q-f22a12a6c7ab0eb3 (open)

Retourwaarden en foutafhandeling

De retourwaarde van het type Std_ReturnType signaleert de status van de leesoperatie ([SWS_Adc_00369]):

• E_OK: Resultaten zijn beschikbaar en zijn succesvol naar de databuffer geschreven ([SWS_Adc_00369]).
• E_NOT_OK: Er zijn geen resultaten beschikbaar of er is een ontwikkelingsfout opgetreden ([SWS_Adc_00369]).

Concurrency

De functie is gespecificeerd als re-entrant ([SWS_Adc_00369]). Deze kan dus parallel worden uitgevoerd, zolang er voor gelijktijdige toegangen gescheiden buffergebieden worden gebruikt.

Gebruik en parameters

De functie Adc_EnableHardwareTrigger activeert de hardware-trigger voor een geconfigureerde ADC-kanaalgroep [SWS_Adc_91001]. Deze is gedefinieerd als service met de Service-ID 0x05 in de module Adc en beschikbaar via het headerbestand Adc.h [SWS_Adc_91001].

• Ingangsparameter: Via de parameter Group van het type Adc_GroupType wordt de numerieke ID van de gewenste ADC-kanaalgroep doorgegeven [SWS_Adc_91001]. Aanvullende in-/uitgangs- of uitgangsparameters bestaan niet [SWS_Adc_91001].
• Retourwaarde: De interface levert geen retourwaarde op (void) [SWS_Adc_91001].
• Asynchrone semantiek: Het uitvoeringsgedrag is vastgelegd als asynchroon [SWS_Adc_91001]. De aanroep schakelt de triggering vrij, terwijl de daadwerkelijke conversie van de kanalen pas door navolgende hardware-gebeurtenissen in gang wordt gezet.

Concurrency

De driver specificeert Adc_EnableHardwareTrigger als re-entrant [SWS_Adc_91001]. Interpretatie: De re-entrantie heeft vermoedelijk in de eerste plaats betrekking op de gelijktijdige aanroep met disjuncte kanaalgroepen, aangezien de hardware-trigger per kanaalgroep wordt geactiveerd. Vraag Q-5750576df9f0284d (open)

De functie Adc_DisableHardwareTrigger dient ertoe om de hardware-triggering voor een aangevraagde ADC-kanaalgroep te deactiveren [SWS_Adc_91002].

Gebruik en semantiek

• Parameter: Doorgegeven wordt de parameter Group van het type Adc_GroupType, die de numerieke ID van de gewenste ADC-kanaalgroep specificeert [SWS_Adc_91002].
• Retourwaarde: De functie heeft geen retourwaarde (void) [SWS_Adc_91002].
• Uitvoeringsgedrag: De aanroep is geclassificeerd als asynchroon (Sync/Async: Asynchronous) [SWS_Adc_91002]. Dit betekent vermoedelijk dat het daadwerkelijke stoppen of ontkoppelen van de hardwaregebeurtenis aan de hardwarezijde met vertraging effectief kan worden. Vraag Q-b0e613163b254242 (open)

Gelijktijdigheid en integratie

De interface is gedeclareerd als re-entrant (Reentrancy: Reentrant) en wordt beschikbaar gesteld via het headerbestand Adc.h; haar service-ID luidt 0x06 [SWS_Adc_91002]. Specifieke foutcodes, aanroepcontexten of DET-/DEM-meldingen zijn niet opgenomen in het onderhavige specificatie-uittreksel.

De functie Adc_EnableGroupNotification dient ertoe het notificatiemechanisme voor een aangevraagde ADC-kanaalgroep te activeren [SWS_Adc_91003]. De declaratie van deze interface wordt via het headerbestand Adc.h voor gebruikers beschikbaar gesteld [SWS_Adc_91003].

Als enige ingangsparameter wordt Group van het datatype Adc_GroupType meegegeven, die de numerieke ID van de aangevraagde ADC-kanaalgroep bepaalt [SWS_Adc_91003]. De functie heeft noch in-/uitgangsparameters noch uitgangsparameters en levert geen retourwaarde (void) op [SWS_Adc_91003]. De service is geregistreerd onder de Service-ID 0x07 en vertoont een asynchrone uitvoeringssemantiek [SWS_Adc_91003].

Wat betreft het concurrency-gedrag is Adc_EnableGroupNotification gespecificeerd als re-entrant [SWS_Adc_91003]. Meerdere parallelle aanroepen zijn dan ook toegestaan. De asynchrone classificatie van de uitvoering betekent waarschijnlijk dat de activering van de groepsnotificatie in de driver wordt voorgemeld of op de achtergrond wordt gerealiseerd, zonder de aanroepende context tijdens de afhandeling te blokkeren [SWS_Adc_91003]. Vraag Q-bae8fba7810fa269 (open)

Over specifieke ontwikkelings- of productiefouten (DET of DEM) en over exacte aanroepvoorwaarden of task-contexten doet het onderhavige specificatie-uittreksel geen verdere uitspraken.

De in de header Adc.h gedeclareerde functie Adc_DisableGroupNotification dient er in de ADC-driver voor om het notificatiemechanisme voor een aangevraagde ADC-kanaalgroep doelgericht uit te schakelen [SWS_Adc_91004]. De service heeft de service-ID 0x08 en is gespecificeerd met de signatuur void Adc_DisableGroupNotification (Adc_GroupType Group) [SWS_Adc_91004].

Parameters en interface

Voor de uitvoering van de functie is de overdracht van één enkele ingangsparameter vastgelegd:

• Group: Geeft als numerieke identificatie van het type Adc_GroupType het unieke ID door van de gewenste ADC-kanaalgroep waarvan de notificatie moet worden gedeactiveerd [SWS_Adc_91004].

De functie levert geen retourwaarde (void) terug aan de aanroeper [SWS_Adc_91004]. Bovendien worden volgens de specificatie noch gecombineerde in-/uitgangsparameters (inout) noch zuivere uitgangsparameters (out) gebruikt [SWS_Adc_91004].

Uitvoeringsgedrag en concurrency

Wat betreft het concurrency-gedrag is Adc_DisableGroupNotification geclassificeerd als re-entrant [SWS_Adc_91004]. Dit staat in beginsel de parallelle of onderbrekende aanroep van de service door verschillende programmacontexten toe [SWS_Adc_91004].

Met betrekking tot de temporele synchronisatie is de functie geclassificeerd als asynchroon [SWS_Adc_91004]. Interpretatie: Aangezien het tijdsgedrag expliciet als asynchroon is gedeclareerd, zal het uitschakelen van het notificatiemechanisme driver-intern of in de ADC-hardware vermoedelijk op de achtergrond plaatsvinden, zonder dat de aanroepende context tot aan de volledige afronding wordt geblokkeerd. Vraag Q-a1a30a254aa96655 (open)

De synchrone servicefunctie Adc_SetPowerState brengt de ADC-module in een vooraf voorbereide energietoestand, die is geselecteerd uit een vooraf geconfigureerde verzameling [SWS_Adc_00475].

Gebruik

De functie is beschikbaar via de header Adc.h en heeft de service-ID 0x10 [SWS_Adc_00475]. Deze accepteert geen invoerparameters, maar geeft het resultaat door via de uitvoerparameter Result van het type Adc_PowerStateRequestResultType* [SWS_Adc_00475]. Bij succesvolle activering van de energietoestand retourneert de functie E_OK en signaleert via Result de toestand ADC_SERVICE_ACCEPTED [SWS_Adc_00475].

Foutafhandeling

Wordt het verzoek afgewezen, dan levert de aanroep de retourwaarde E_NOT_OK op [SWS_Adc_00475]. De module maakt daarbij in de parameter Result onderscheid tussen drie specifieke foutoorzaken:

• ADC_NOT_INIT: De ADC-module is op het aanroeptijdstip nog niet geïnitialiseerd [SWS_Adc_00475].
• ADC_SEQUENCE_ERROR: Er is sprake van een onjuiste volgorde van de API-aanroepen [SWS_Adc_00475].
• ADC_HW_FAILURE: Een opgetreden hardwarefout verhindert het aannemen van de aangevraagde toestand [SWS_Adc_00475].

Gelijktijdigheid en beperkingen

Adc_SetPowerState is niet-re-entrant (Non Reentrant) en blokkeert de aanroeper tot de synchrone overname van de toestand [SWS_Adc_00475]. Als interpretatie geldt dat er vóór de aanroep verplicht een voorbereidingsstap voor de doeltoestand moet zijn uitgevoerd, aangezien de functie expliciet een reeds voorbereide toestand aanvraagt en volgordefouten met ADC_SEQUENCE_ERROR afwijst [SWS_Adc_00475].

Gebruik en aanroepcontext

De synchrone functie Adc_PreparePowerState brengt het vereiste voorbereidingsproces op gang om de ADC-hardwaremodule naar een aangevraagde energietoestand over te brengen [SWS_Adc_00478]. Als parameters worden de gewenste doeltoestand PowerState en een pointer Result meegegeven, waarmee de status van het verzoek wordt teruggemeld [SWS_Adc_00478]. De retourwaarde signaleert met E_OK dat het voorbereidingsproces is gestart, of met E_NOT_OK dat de service is afgewezen [SWS_Adc_00478].

Resultaat- en foutafhandeling

In het geval van succes (E_OK) levert de uitvoerparameter Result de statuswaarde ADC_SERVICE_ACCEPTED op [SWS_Adc_00478]. Werd de service met E_NOT_OK afgewezen, dan specificeert Result de exacte oorzaak [SWS_Adc_00478]:

• ADC_NOT_INIT: De ADC-module is nog niet geïnitialiseerd [SWS_Adc_00478].
• ADC_SEQUENCE_ERROR: Niet-toegestane aanroepsequentie, aangezien de huidige toestand al overeenkomt met de doeltoestand [SWS_Adc_00478].
• ADC_POWER_STATE_NOT_SUPP: De aangevraagde energietoestand wordt niet door de module ondersteund [SWS_Adc_00478].
• ADC_TRANS_NOT_POSSIBLE: Een directe overgang is niet mogelijk of het randapparaat van de hardware is nog bezig [SWS_Adc_00478].

Gelijktijdigheid en wisselwerking

De functie is gespecificeerd als niet-re-entrant [SWS_Adc_00478]. Daarom moet de aanroeper ervoor zorgen dat aanroepen sequentieel en zonder overlapping plaatsvinden. Aanroepers dienen lopende conversies vermoedelijk vooraf af te ronden of te stoppen, aangezien actieve hardware-randapparatuur leidt tot afwijzing. Vraag Q-210c59a46a90d781 (open) Na een succesvolle voorbereiding door Adc_PreparePowerState worden navolgende, niet direct effectieve acties ter afronding van de toestandsovergang uitgevoerd via een bijbehorende vervolg-API [SWS_Adc_00499].

Gebruik en aanroepcontext

De hoofdfunctie Adc_Main_PowerTransitionManager dient voor de cyclische bewaking en afhandeling van energietoestandsovergangen in de ADC-module [SWS_Adc_00479]. Deze heeft de signatuur void Adc_Main_PowerTransitionManager(void), accepteert geen invoerparameters en levert geen retourwaarde op [SWS_Adc_00479]. De functie wordt cyclisch aangeroepen en gedeclareerd via de header SchM_Adc.h [SWS_Adc_00479]. De aanroep zal daarom typisch plaatsvinden in de cyclische task-context van de BSW-scheduler (SchM). Vraag Q-4fc01e5bed5b3b57 (open)

Toestandsbewaking en asynchrone processen

Tijdens de cyclische uitvoering controleert de functie continu de bedrijfsgereedheid van de module voor de aangevraagde energietoestand [SWS_Adc_00479]. Zodra de gereedheid van de module wordt vastgesteld, verzendt zij de meldings-callbacks IoHwAb_Adc_NotifyReadyForPowerState<Mode>, die via de configuratieparameter AdcPowerStateReadyCbkRef worden gerefereerd [SWS_Adc_00479]. Alle asynchrone operaties die nodig zijn om de doel-energietoestand te bereiken, kunnen op de achtergrond in de uitvoeringscontext van Adc_Main_PowerTransitionManager worden afgehandeld [SWS_Adc_00498].

Foutafhandeling en randvoorwaarden

Indien een aangevraagde energietoestand niet direct vanuit de huidige energietoestand kan worden bereikt, meldt de API de runtime-fout ADC_E_TRANSITION_NOT_POSSIBLE [SWS_Adc_00498]. Door het uitbesteden van langere overgangsprocessen naar deze cyclische managerfunctie worden bovenliggende aanroepers niet geblokkeerd terwijl de ADC-module de toestandswissel op de achtergrond voltooit [SWS_Adc_00498].

De functie IoHwAb_Adc_NotifyReadyForPower dient als notificatie-interface van de I/O-hardware-abstractie en wordt door de ADC-driver aangeroepen zodra de voorbereiding voor een aangevraagde energietoestand in de modus <#Mode> is afgerond [SWS_Adc_00480]. De declaratie van deze interface wordt aangeboden via het headerbestand IoHwAb_Adc.h [SWS_Adc_00480].

Aanroepcontext en semantiek

Voor de aanroep gelden conform de specificatie de volgende randvoorwaarden [SWS_Adc_00480]:

• Parameters en retourwaarde: De functie heeft noch invoer-, uitvoer- noch in-/uitvoerparameters en levert geen retourwaarde (void) [SWS_Adc_00480].
• Synchroniciteit: Het uitvoeringsgedrag is gedefinieerd als synchroon [SWS_Adc_00480].
• Re-entrantie: De functie is geclassificeerd als niet-re-entrant (Non Reentrant) [SWS_Adc_00480]. Aanroepers moeten er daarom voor zorgen dat aanroepen sequentieel plaatsvinden en niet gelijktijdig overlappen.

Samenspel en foutafhandeling

In de specificatiegegevens zijn geen foutcodes of notificaties aan DET of DEM vastgelegd [SWS_Adc_00480]. De syntaxisaanduiding IoHwAb_Adc_NotifyReadyForPowerState<#Mode> duidt er vermoedelijk op dat de identifier specifiek wordt gegenereerd op basis van de geconfigureerde powermodus. Vraag Q-9e9c969f8a41d0de (open) De functie fungeert vermoedelijk als callback van de driver om aan het bovenliggende power management de gereedheid voor de overgang te signaleren.

Het enumeratietype Adc_StatusType representeert conform [SWS_Adc_00513] de actuele conversiestatus van een opgevraagde ADC-kanaalgroep en wordt aangeboden via de header Adc.h.

De enumeratiewaarden weerspiegelen de voortgang van de analoog-digitaalconversie en de beschikbaarheid van resultaten [SWS_Adc_00513]:

• ADC_IDLE (0x00): De conversie van de opgegeven groep is nog niet gestart; er zijn geen meetresultaten beschikbaar [SWS_Adc_00513].
• ADC_BUSY (0x01): De conversie van de groep is gestart en loopt momenteel nog; tot nu toe is er geen resultaat beschikbaar [SWS_Adc_00513].
• ADC_COMPLETED (0x02): Een conversieronde (die niet de finale is) van de groep is voltooid; voor alle kanalen van de groep is een resultaat beschikbaar [SWS_Adc_00513].
• ADC_STREAM_COMPLETED (0x03): De resultaatbuffer is volledig gevuld; voor elk kanaal van de geselecteerde groep is het vereiste aantal samples beschikbaar [SWS_Adc_00513].

In toepassingen dient het type typisch voor het opvragen of evalueren van de groepsvoortgang om vast te stellen of resultaten al kunnen worden uitgelezen of dat verdere bemonsteringen nog moeten plaatsvinden.

Het enumeratietype Adc_GroupConvModeType dient voor de configuratie van de conversiemodus van een ADC-kanaalgroep en wordt gedeclareerd via het headerbestand Adc.h [SWS_Adc_00515]. Het type bepaalt of de kanalen van een groep na de geconfigureerde triggergebeurtenis eenmalig of herhaaldelijk worden geconverteerd [SWS_Adc_00515].

Voor de configuratie zijn twee modi beschikbaar [SWS_Adc_00515]:

• ADC_CONV_MODE_ONESHOT (0x00): Voert na de geconfigureerde triggergebeurtenis precies één conversie uit van elk kanaal van de ADC-kanaalgroep [SWS_Adc_00515]. Als als triggerbron een software-trigger is geconfigureerd, kan een gestarte conversie worden gestopt via een software-API-aanroep [SWS_Adc_00515]. Is daarentegen een hardware-triggerbron toegewezen, dan kan een gestarte one-shot-conversie worden gestopt door het deactiveren van de triggergebeurtenis, voor zover dit door de hardware wordt ondersteund [SWS_Adc_00515].
• ADC_CONV_MODE_CONTINUOUS (0x01): Voert doorlopend herhaalde conversies uit van elk kanaal binnen de kanaalgroep [SWS_Adc_00515]. Deze continue modus is uitsluitend beschikbaar voor groepen met een software-triggerbron [SWS_Adc_00515]. Een reeds gestarte continue conversieronde kan te allen tijde worden beëindigd via een software-API-aanroep [SWS_Adc_00515].

Wat betreft de restricties dient te worden opgemerkt dat ADC_CONV_MODE_CONTINUOUS alleen is toegestaan met software-triggering en niet kan worden gecombineerd met hardware-triggerbronnen [SWS_Adc_00515]. Het stoppen van lopende conversies vereist bij software-triggers een speciale software-API-aanroep, terwijl hardware-getriggerde one-shot-processen het uitschakelen van het trigger-event vereisen [SWS_Adc_00515].

Het enumeratietype Adc_StreamBufferModeType dient voor de configuratie van het buffergedrag in de streaming-toegangsmodus van de ADC-driver en is beschikbaar via het headerbestand Adc.h [SWS_Adc_00519].

Het type definieert twee specifieke bedrijfsmodi voor het bufferbeheer bij streaming-conversies [SWS_Adc_00519]:

• ADC_STREAM_BUFFER_LINEAR (waarde 0x00): De ADC-driver beëindigt de conversie automatisch zodra de streambuffer vol is respectievelijk het vastgelegde aantal samples is bereikt [SWS_Adc_00519].
• ADC_STREAM_BUFFER_CIRCULAR (waarde 0x01): De ADC-driver zet de conversie ook na het bereiken van de volledige buffercapaciteit voort door terug te springen naar het begin van de buffer en deze circulair te overschrijven [SWS_Adc_00519].

Integrerende lagen en applicatiesoftware moeten het buffergedrag afstemmen op de respectievelijke verwerkingsstrategie: terwijl ADC_STREAM_BUFFER_LINEAR bedoeld is voor op zichzelf staande meetreeksen met een vaste samplegrootte, vereist ADC_STREAM_BUFFER_CIRCULAR vermoedelijk een continue bufferbewaking of tijdige gegevensafname om onopgemerkt gegevensverlies door het automatische overschrijven te voorkomen [SWS_Adc_00519]. Vraag Q-23b411e5e6c50591 (open)

Het enumeratietype Adc_GroupAccessModeType dient voor de configuratie van de toegangsmodus tot de conversieresultaten van een ADC-kanaalgroep conform [SWS_Adc_00528]. De typedefinitie wordt via het headerbestand Adc.h beschikbaar gesteld en legt vast hoe resultaten in het geheugen worden opgeslagen.

Voor de configuratie van de groepstoegangsmodus zijn in de specificatie twee waarden gedefinieerd [SWS_Adc_00528]:

• ADC_ACCESS_MODE_SINGLE (waarde 0x00): Configureert de enkelvoudige-waardetoegangsmodus (Single value access mode) voor de betreffende groep.
• ADC_ACCESS_MODE_STREAMING (waarde 0x01): Configureert de streaming-toegangsmodus (Streaming access mode) voor de betreffende groep.

Het type wordt gebruikt bij de configuratie van de ADC-driver om het toegangsgedrag tot de buffers van de conversieresultaten te sturen [SWS_Adc_00528]. Interpretatie: Terwijl de enkelvoudige-waardemodus vermoedelijk is ontworpen voor het beschikbaar stellen van een enkele actuele resultaatwaarde per groepskanaal, is de streaming-modus waarschijnlijk ontworpen voor meer continue meetreeksen met meerdere bufferwaarden. Vraag Q-8a933cffcd1132ef (open)

Aangezien het om een puur configuratietype gaat, definieert de eis geen eigen foutcodes, retourwaarden of DET-/DEM-meldingen voor dit type [SWS_Adc_00528].

Gebruik en waardebereik

Het enumeratietype Adc_ResultAlignmentType wordt via het headerbestand Adc.h beschikbaar gesteld en dient in de module Adc voor het vastleggen van de uitlijning van ruwe ADC-waarden in de resultaatbuffer [SWS_Adc_00525]. Het vormt de gestandaardiseerde interface voor het configureren van de bufferopslag van het stuurprogramma [SWS_Adc_00525]. Als zuiver datatype heeft het geen eigen functieparameters, retourwaarden of asynchrone semantiek [SWS_Adc_00525].

Het waardebereik van de enumeratie omvat volgens de specificatie precies twee varianten [SWS_Adc_00525]:

• ADC_ALIGN_LEFT (numerieke waarde 0x00): Configureert een linkslijnende uitlijning van de conversieresultaten in de buffer [SWS_Adc_00525].
• ADC_ALIGN_RIGHT (numerieke waarde 0x01): Configureert een rechtslijnende uitlijning van de conversieresultaten in de buffer [SWS_Adc_00525].

Betekenis en randvoorwaarden

Via de gekozen waarde wordt bepaald op welke bitposities van het bufferbereik de ruwe data na een conversie worden opgeslagen [SWS_Adc_00525]. Hierdoor wordt vastgelegd of significante databits links- of rechtslijnend in het geheugen liggen [SWS_Adc_00525]. Interpretatie: De vastlegging op links- of rechtslijning zal vermoedelijk met name relevant zijn wanneer de hardware-resolutie van de analoog-digitaalomzetter kleiner is dan de elementbreedte van het toegewezen buffergeheugen. Vraag Q-54221124172a3d87 (open) Stroomafwaartse softwarecomponenten moeten rekening houden met de geconfigureerde uitlijning om ruwe waarden zonder reken- of bitverschuivingsfouten te kunnen uitlezen.

Specifieke foutcodes, DET- of DEM-meldingen bestaan niet voor deze enumeratie [SWS_Adc_00525].

Het enumeratietype Adc_PowerStateType definieert in AUTOSAR Classic de energiestatus van de ADC-driver [SWS_Adc_00526]. Het wordt in de driver gebruikt om ofwel de actueel aangenomen bedrijfstoestand van de module weer te geven, ofwel een nieuw aan te sturen doeltoestand voor het energiebeheer voor te schrijven [SWS_Adc_00526]. De declaratie van dit datatype wordt via de header Adc.h beschikbaar gesteld [SWS_Adc_00526].

Voor de afzonderlijke toestanden van de enumeratie legt de specificatie een hiërarchische ordening vast met betrekking tot het stroomverbruik [SWS_Adc_00526]:

• ADC_FULL_POWER (getalswaarde 0): Duidt de volledige bedrijfs- en functiemodus van de ADC-driver aan zonder stroombeperkingen [SWS_Adc_00526].
• Waardebereik 1 tot 255: Representeert optionele energiebesparende modi met stapsgewijs afnemend stroomverbruik [SWS_Adc_00526].

Met betrekking tot de wisselwerking en de integratie in de systeemomgeving geldt de interpretatie: Het type zal vermoedelijk primair dienen als overdrachtsparameter in aansturingsfuncties voor power-state-overgangen en voor statusterugmelding aan bovenliggende modules zoals het BSW- of ECU-state-management. Vraag Q-e4f964bd79ad550c (open) Omdat het om een elementaire datatypedefinitie gaat, zijn specifieke eigenschappen zoals aanroepcontexten, re-entrancy-eisen, synchrone of asynchrone semantiek evenals runtime-fouten en DET-meldingen pas in de bijbehorende driver-API's gedefinieerd en geen onderdeel van deze typebeschrijving [SWS_Adc_00526].

Het enumeratietype Adc_PowerStateRequestResultType definieert de retourwaarden voor verzoeken om toestandsovergangen in het power management van de ADC-driver en wordt via het headerbestand Adc.h beschikbaar gesteld [SWS_Adc_00527].

De waarden van het type representeren het succes of specifieke foutoorzaken van een aangevraagde power-state-wissel [SWS_Adc_00527]:

• ADC_SERVICE_ACCEPTED (0): De overgang naar de gewenste toestand is succesvol uitgevoerd [SWS_Adc_00527].
• ADC_NOT_INIT (1): De aanroep is mislukt omdat de ADC-module nog niet is geïnitialiseerd [SWS_Adc_00527].
• ADC_SEQUENCE_ERROR (2): Er is sprake van een onjuiste volgorde bij het aanroepen van de API's [SWS_Adc_00527].
• ADC_HW_FAILURE (3): Een hardwarefout verhindert de overgang naar de vereiste toestand [SWS_Adc_00527].
• ADC_POWER_STATE_NOT_SUPP (4): De vereiste power-state wordt niet ondersteund door de ADC-module [SWS_Adc_00527].
• ADC_TRANS_NOT_POSSIBLE (5): Een directe overgang van de actuele naar de gewenste toestand is niet mogelijk of de hardware-periferie is nog bezig [SWS_Adc_00527].

Aanroepers moeten de retourwaarde evalueren om onderscheid te maken tussen reguliere uitvoering en foutieve condities zoals een onjuiste sequentie, ontbrekende module-initialisatie of hardwareconflicten [SWS_Adc_00527].