FlexRay Driver (Fr)

De synchrone functie Fr_Init dient voor de initialisatie van de FlexRay-driver (Fr) conform [SWS_Fr_00032]. Deze is gedeclareerd via het headerbestand Fr.h en heeft het service-ID 0x1c [SWS_Fr_00032]. Als enige ingangsparameter verwacht de interface Fr_ConfigPtr van het type const Fr_ConfigType* [SWS_Fr_00032]. Deze pointer verwijst naar een driverafhankelijke configuratiestructuur, die alle vereiste informatie voor de aansluitende operationele werking van de FlexRay-driver levert [SWS_Fr_00032]. De functie heeft noch in-/uitgangsparameters noch uitgangsparameters en levert geen retourwaarde op (void) [SWS_Fr_00032].

Met betrekking tot gelijktijdigheid en beperkingen is Fr_Init gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Fr_00032]. Aanroepen mogen daarom geenszins parallel of genest plaatsvinden. Aangezien de meegegeven configuratiestructuur alle fundamentele gegevens voor de verdere werking bevat, zal de initialisatie doorgaans sequentieel in de opstartfase van het totale systeem plaatsvinden, voordat verdere moduleservices worden aangeroepen [SWS_Fr_00032]. Vraag Q-a208c696fbb083d4 (open)

Foutafhandeling via specifieke foutcodes of statusterugmeldingen is niet voorzien in de servicedefinitie [SWS_Fr_00032]. Verdergaande vereisten, bijvoorbeeld met betrekking tot meldingen aan DET of DEM, zijn in de onderhavige gegevensset niet gedocumenteerd.

De synchrone functie Fr_ControllerInit dient voor de initialisatie van een FlexRay Communication Controller (FlexRay CC) in de context van het FlexRay-stuurprogramma [SWS_Fr_00017]. Deze is gedeclareerd in het headerbestand Fr.h en heeft de service-ID 0x00 [SWS_Fr_00017]. Via de invoerparameter Fr_CtrlIdx van het type uint8 wordt de index van de te initialiseren controller doorgegeven [SWS_Fr_00017].

Als retourwaarde levert de functie de status Std_ReturnType [SWS_Fr_00017]:

• E_OK: de API-aanroep is met succes voltooid [SWS_Fr_00017].
• E_NOT_OK: De aanroep is wegens opgetreden fouten voortijdig afgebroken [SWS_Fr_00017].

Gedetailleerde foutcodes en meldingen aan DET of DEM zijn niet opgenomen in de gespecificeerde interfaceomvang [SWS_Fr_00017].

Wat betreft gelijktijdigheid is de functie geclassificeerd als niet-re-entrant voor dezelfde hardware-eenheid (Non Reentrant for the same device) [SWS_Fr_00017]. Daarom mag een aanroep voor dezelfde controllerindex Fr_CtrlIdx niet gelijktijdig plaatsvinden; parallelle aanroepen voor verschillende controllers zijn daarentegen vermoedelijk toegestaan [SWS_Fr_00017]. Vraag Q-5bbbba38e8530b43 (open) Aangezien er geen invoer- en uitvoerparameters (inout/out) zijn gedefinieerd, vindt de initialisatie puur toestandsgebaseerd plaats in het stuurprogramma [SWS_Fr_00017].

De functie Fr_StartCommunication dient voor het starten van de FlexRay-communicatie op een opgegeven controller [SWS_Fr_00010]. De interface is beschikbaar via het headerbestand Fr.h [SWS_Fr_00010].

Gebruik

De aanroep vindt asynchroon plaats onder doorgifte van de parameter Fr_CtrlIdx (service-ID 0x03), die de index van de FlexRay-communicatiecontroller in de drivercontext aangeeft [SWS_Fr_00010]. Als retourwaarde levert de functie een status van het type Std_ReturnType [SWS_Fr_00010]:

• E_OK: De API-aanroep is succesvol beëindigd [SWS_Fr_00010]. Interpretatie: Vanwege de asynchrone semantiek duidt dit vermoedelijk op de succesvolle acceptatie van het startcommando, terwijl de eigenlijke verbindingsopbouw aansluitend plaatsvindt. Vraag Q-fabca57ea7d32a05 (open)
• E_NOT_OK: De API-aanroep is afgebroken als gevolg van fouten [SWS_Fr_00010].

Gelijktijdigheid en beperkingen

Voor dezelfde FlexRay-controller is Fr_StartCommunication als niet-reentrant gespecificeerd [SWS_Fr_00010]. Voor verschillende controllerinstanties is de aanroep daarentegen reentrant. Specifieke ontwikkelingsfouten (DET), foutmeldingen (DEM) of verdere afhankelijkheden zijn niet opgenomen in de beschikbare specificatiegegevens.

Gebruik

De functie Fr_AllowColdstart dient voor het aanroepen van het Controller-Host-Interface-commando ALLOW_COLDSTART op de FlexRay Communication Controller [SWS_Fr_00114]. De declaratie wordt beschikbaar gesteld via het headerbestand Fr.h; de service heeft de service-ID 0x23 [SWS_Fr_00114]. Via de overdrachtsparameter Fr_CtrlIdx wordt de index van de aan te spreken FlexRay-controller binnen de FlexRay-driver aangegeven [SWS_Fr_00114]. De aanroep wordt asynchroon uitgevoerd [SWS_Fr_00114].

Foutafhandeling en retourwaarden

De functie retourneert een status van het type Std_ReturnType [SWS_Fr_00114]:

• E_OK: De API-aanroep is succesvol beëindigd [SWS_Fr_00114].
• E_NOT_OK: De API-aanroep is afgebroken als gevolg van fouten [SWS_Fr_00114].

Specifieke foutoorzaken of meldingen aan DEM resp. DET zijn voor deze service niet afzonderlijk vermeld in de functiespecificatie [SWS_Fr_00114].

Gelijktijdigheid en beperkingen

De interface is voor dezelfde controllerinstantie niet-reentrant (Non Reentrant for the same device) [SWS_Fr_00114]. Aanroepen met dezelfde parameter Fr_CtrlIdx mogen daarom niet parallel of onderbrekend plaatsvinden [SWS_Fr_00114]. Interpretatie: Vanwege de asynchrone uitvoeringssemantiek bevestigt de retourwaarde E_OK vermoedelijk uitsluitend de acceptatie van het CHI-commando door de driver, terwijl de controllerinterne statuswijziging in de tijd verschoven plaatsvindt [SWS_Fr_00114]. Vraag Q-e5c407f32c449510 (open)

Gebruik en werking

De functie Fr_AllSlots dient voor het versturen van het CHI-commando (Controller Host Interface) ALL_SLOTS naar de geadresseerde FlexRay-communication-controller [SWS_Fr_00516]. Deze wordt via de header Fr.h beschikbaar gesteld en heeft het service-ID 0x24 [SWS_Fr_00516].

Als ingangsparameter verwacht de functie Fr_CtrlIdx, die de index van de betreffende FlexRay-controller in de context van de FlexRay-driver aangeeft [SWS_Fr_00516]. De uitvoering vindt asynchroon plaats [SWS_Fr_00516]. De retourwaarde E_OK geeft aan dat de API-aanroep succesvol is afgerond, terwijl E_NOT_OK een afbreking als gevolg van fouten aangeeft [SWS_Fr_00516]. Vanwege de asynchrone semantiek bevestigt E_OK vermoedelijk slechts de succesvolle aanname resp. het initiëren van het CHI-commando en niet de voltooide hardwarereactie van de controller (interpretatie). Vraag Q-c526e3b174a4b44a (open)

Foutafhandeling en gelijktijdigheid

Mislukt de uitvoering, dan breekt de aanroep af met de retourwaarde E_NOT_OK [SWS_Fr_00516]. Concrete foutoorzaken of DET-/DEM-meldingen worden in de specificatie van dit element niet genoemd.

Wat de re-entrantie betreft is Fr_AllSlots gespecificeerd als niet-re-entrant voor dezelfde controller (Non Reentrant for the same device) [SWS_Fr_00516]. Gelijktijdige aanroepen voor dezelfde controllerinstantie moeten daarom door hogere lagen worden vermeden. Parallelle aanroepen voor verschillende controllerinstanties zijn daarentegen vermoedelijk toegestaan (interpretatie). Vraag (open)

De functie Fr_HaltCommunication dient ertoe het stoppen van de communicatie op een FlexRay-communicatiecontroller in te leiden door het CC-CHI-commando 'DEFERRED_HALT' uit te voeren [SWS_Fr_00014].

Gebruik en parameters

De aanroep vindt asynchroon plaats en wordt beschikbaar gesteld via de header Fr.h (service-ID 0x04) [SWS_Fr_00014]:

• Fr_CtrlIdx (invoerparameter): Bepaalt de index van de aan te sturen FlexRay-communicatiecontroller binnen het FlexRay-stuurprogramma [SWS_Fr_00014].
• Retourwaarde (Std_ReturnType): Geeft E_OK terug wanneer de functieaanroep met succes is voltooid, of E_NOT_OK wanneer de aanroep als gevolg van fouten is afgebroken [SWS_Fr_00014].

Gelijktijdigheid en beperkingen

Wat betreft de aanroepcontext en gelijktijdigheid is Fr_HaltCommunication niet-re-entrant met betrekking tot hetzelfde apparaat (Non Reentrant for the same device) [SWS_Fr_00014]. Voor dezelfde controllerindex mag bijgevolg geen gelijktijdige of overlappende aanroep plaatsvinden. Aanroepen voor verschillende controllerinstanties zijn daarentegen toegestaan.

Foutafhandeling

Treedt tijdens de aanroep een fout op, dan breekt de functie de uitvoering af en signaleert dit via de retourwaarde E_NOT_OK [SWS_Fr_00014]. Gedetailleerde foutmeldingen zijn voor deze functie niet opgenomen in de specificatieomvang.

De synchrone functie Fr_AbortCommunication breekt de lopende communicatie af door het Controller-Host-Interface-commando (CHI-commando) FREEZE op de opgegeven FlexRay-communicatiecontroller (CC) uit te voeren [SWS_Fr_00011].

Aanroep en parameters

De aanroep vindt plaats via de header Fr.h onder vermelding van de controllerindex Fr_CtrlIdx, die de doel-FlexRay-CC binnen de context van het FlexRay-stuurprogramma eenduidig identificeert [SWS_Fr_00011]. Invoer- en uitvoerparameters bestaan daarnaast niet.

Retourwaarden en foutafhandeling

De functie retourneert een status van het type Std_ReturnType [SWS_Fr_00011]:

• E_OK: de API-aanroep is met succes voltooid [SWS_Fr_00011].
• E_NOT_OK: De API-aanroep is afgebroken wegens fouten [SWS_Fr_00011].

Gelijktijdigheid en beperkingen

Wat betreft het gedrag bij gelijktijdigheid is Fr_AbortCommunication gespecificeerd als niet-re-entrant voor dezelfde communicatiecontroller (Non Reentrant for the same device) [SWS_Fr_00011]. Parallelle aanroepen voor dezelfde controllerinstantie moeten door de oproeper worden vermeden.

Gebruik en semantiek

De functie Fr_SendWUP dient voor het in gang zetten van een wakeup-procedure op de FlexRay-bus door het verzenden van het CHI-commando WAKEUP naar de communicatiecontroller [SWS_Fr_00009]. Via de parameter Fr_CtrlIdx wordt de index van de doelcontroller in de drivercontext doorgegeven [SWS_Fr_00009]. De aanroep verloopt asynchroon; de interface initieert het commando, terwijl de verzending van het wakeup-patroon vervolgens hardwarematig wordt uitgevoerd [SWS_Fr_00009]. De declaratie is beschikbaar via Fr.h en de service heeft service-ID 0x06 [SWS_Fr_00009].

Foutafhandeling en retourwaarden

De functie retourneert een statuswaarde van het type Std_ReturnType [SWS_Fr_00009]:

• E_OK: De API-aanroep is met succes uitgevoerd en het CHI-commando is verzonden [SWS_Fr_00009].
• E_NOT_OK: De API-aanroep is afgebroken vanwege opgetreden fouten [SWS_Fr_00009].

Gelijktijdigheid en beperkingen

De functie is gespecificeerd als niet re-entrant voor hetzelfde apparaat (Non Reentrant for the same device) [SWS_Fr_00009]. Interpretatie: dit zal vermoedelijk betekenen dat bovenliggende modules gelijktijdige aanroepen voor dezelfde controllerinstantie moeten synchroniseren, terwijl aanroepen voor verschillende controllerinstanties gelijktijdig mogen worden uitgevoerd. Vraag Q-0e3b4e70a0755877 (open) Er zijn noch invoer-/uitvoerparameters noch zuivere uitvoerparameters gedefinieerd [SWS_Fr_00009].

De functie Fr_TransmitTxLPdu dient voor de overdracht van payloadgegevens via het FlexRay-netwerk [SWS_Fr_00092]. Deze verwerkt de verzendopdracht met asynchrone semantiek en wijst de over te dragen LSdu toe aan het door Fr_LPduIdx geïdentificeerde FlexRay-frame [SWS_Fr_00092].

Gebruik en parameters

De aanroep vindt plaats via het headerbestand Fr.h (service-ID 0x0b) onder vermelding van de controllerindex Fr_CtrlIdx voor de FlexRay Communication Controller evenals de eenduidige frame-index Fr_LPduIdx [SWS_Fr_00092]. Via de pointer Fr_LSduPtr wordt de in de buffer klaargezette verzend-LSdu doorgegeven, waarvan de gegevenslengte in bytes via Fr_LSduLength wordt gespecificeerd [SWS_Fr_00092]. Via de uitvoerparameter Fr_SlotAssignmentPtr kan de oproeper de feitelijke verzendcyclus, de slot-ID en het FlexRay-kanaal opvragen; als deze informatie niet nodig is, kan hiervoor een NULL_PTR worden doorgegeven [SWS_Fr_00092].

Retourwaarden en foutafhandeling

De functie bevestigt de aanroep met het retourtype Std_ReturnType: De retourwaarde E_OK bevestigt de succesvolle voltooiing van de API-aanroep, terwijl E_NOT_OK een afbreking als gevolg van fouten signaleert [SWS_Fr_00092]. Specifieke DET- of DEM-meldingen zijn niet opgenomen in de specificatiegegevens.

Concurrency

Wat betreft gelijktijdigheid is Fr_TransmitTxLPdu gespecificeerd als niet-re-entrant voor hetzelfde apparaat (Non Reentrant for the same device) [SWS_Fr_00092]. Parallelle verzendaanroepen voor dezelfde FlexRay-controller zijn daarom niet toegestaan.

Gebruik en semantiek

De synchrone functie Fr_CancelTxLPdu breekt de reeds openstaande overdracht af van een L-PDU die zich in een fysieke zendresource van de controller (bijv. een zendbuffer) bevindt [SWS_Fr_00610]. De functie is gedeclareerd in de header Fr.h en heeft het service-ID 0x2d [SWS_Fr_00610].

Voor de identificatie van de af te breken overdracht verwacht de interface twee parameters [SWS_Fr_00610]:

• Fr_CtrlIdx: Index van de FlexRay-Communication-Controller in de context van de FlexRay-driver [SWS_Fr_00610].
• Fr_LPduIdx: Unieke index ter identificatie van het desbetreffende FlexRay-frame [SWS_Fr_00610].

Retourwaarden en foutafhandeling

De functieaanroep retourneert een statuswaarde van het type Std_ReturnType [SWS_Fr_00610]:

• E_OK: de API-aanroep is met succes voltooid [SWS_Fr_00610].
• E_NOT_OK: De aanroep is afgebroken als gevolg van fouten [SWS_Fr_00610].

Specifieke foutcodes, DET- of DEM-ingangen zijn voor deze functie niet gedocumenteerd; bij een opgetreden fout signaleert de functie deze uitsluitend via de retourwaarde E_NOT_OK [SWS_Fr_00610].

Gelijktijdigheid en beperkingen

Wat betreft het gedrag bij gelijktijdigheid is Fr_CancelTxLPdu gespecificeerd als niet-re-entrant voor hetzelfde apparaat (Non Reentrant for the same device) [SWS_Fr_00610]. Dit betekent vermoedelijk dat parallelle aanroepen voor dezelfde controllerinstantie op aanroepersniveau moeten worden gesynchroniseerd. Vraag Q-ec480944eec04076 (open) Verdere invoer- of uitvoerparameters zijn niet aanwezig [SWS_Fr_00610].

De synchrone functie Fr_ReceiveRxLPdu dient voor de ontvangst van payloadgegevens vanuit het FlexRay-netwerk en is beschikbaar via de header Fr.h [SWS_Fr_00093].

Parameters en gebruik

Via de invoerparameters Fr_CtrlIdx en Fr_LPduIdx worden de betreffende communicatiecontroller van het FlexRay-stuurprogramma evenals het te ontvangen FlexRay-frame eenduidig geadresseerd [SWS_Fr_00093]. De payload- en statusgegevens worden via meerdere pointers aan de oproeper overgedragen:

• Fr_LSduPtr: Pointer naar de buffer waarin de ontvangen L-SDU moet worden opgeslagen.
• Fr_LPduStatusPtr: Pointer naar de geheugenlocatie voor de ontvangststatus van de L-PDU.
• Fr_LSduLengthPtr: Geheugenlocatie voor de lengte van de ontvangen L-SDU in bytes, overeenkomend met het aantal naar Fr_LSduPtr gekopieerde bytes.
• Fr_SlotAssignmentPtr: Geheugenlocatie voor cyclus, slot-ID en kanaal van het frame. Wordt hiervoor een NULL_PTR doorgegeven, dan signaleert dit dat de oproeper deze toewijzingsinformatie niet nodig heeft.

Gelijktijdigheid en foutafhandeling

De interface wordt synchroon uitgevoerd, maar is voor hetzelfde apparaat niet-re-entrant [SWS_Fr_00093]. Een succesvolle ontvangstbewerking wordt met E_OK bevestigd, terwijl bij opgetreden fouten de aanroep wordt afgebroken en E_NOT_OK wordt teruggegeven [SWS_Fr_00093]. Specifieke DET- of DEM-foutcodes zijn niet vermeld in de specificatiegegevens van de functie.

De synchrone interface Fr_CheckTxLPduStatus (service-ID 0x0d) dient conform [SWS_Fr_00094] voor de controle van de actuele verzendstatus van een L-SDU resp. een FlexRay-frame in het FlexRay-stuurprogramma. Deze wordt beschikbaar gesteld via de header Fr.h.

Als invoerparameters vereist de functie de index van de FlexRay-communicatiecontroller (Fr_CtrlIdx) evenals de index Fr_LPduIdx, die het te controleren FlexRay-frame in het stuurprogramma eenduidig identificeert [SWS_Fr_00094]. De vastgestelde verzendstatus van de LPdu wordt via de uitvoerparameter Fr_TxLPduStatusPtr naar het doorgegeven geheugenadres weggeschreven [SWS_Fr_00094].

Daarnaast maakt de uitvoerparameter Fr_SlotAssignmentPtr het bepalen van de slottoewijzing mogelijk: deze verwijst naar een geheugenlocatie waarop de feitelijke cyclus, de slot-ID evenals het kanaal van het geadresseerde frame worden opgeslagen [SWS_Fr_00094]. Heeft de oproeper deze toewijzingsinformatie niet nodig, dan signaleert het doorgeven van een NULL_PTR dat deze gegevens niet beschikbaar hoeven te worden gesteld [SWS_Fr_00094].

De interface moet synchroon worden uitgevoerd en is voor hetzelfde apparaat gespecificeerd als niet-re-entrant (Non Reentrant for the same device) [SWS_Fr_00094]. Bij succesvolle voltooiing levert de aanroep de retourwaarde E_OK; in het geval van opgetreden fouten breekt de functie af en geeft E_NOT_OK terug [SWS_Fr_00094].

Gebruik en semantiek

De synchrone functie Fr_PrepareLPdu dient conform [SWS_Fr_00107] voor de voorbereiding van een L-PDU (Prepares a LPdu) en wordt via de header Fr.h beschikbaar gesteld. Als ingangsparameter verwacht de service de controllerindex Fr_CtrlIdx voor de adressering van de FlexRay Communication Controller (CC) in de drivercontext evenals Fr_LPduIdx voor de unieke identificatie van het bijbehorende FlexRay-frame [SWS_Fr_00107]. Interpretatie: De aanroep zal vermoedelijk hardwarespecifieke bufferstructuren voor het aansluitende verzend- of ontvangstproces van het frame initialiseren of activeren. Vraag Q-c4375099d73dbea2 (open)

Gelijktijdigheid en beperkingen

Wat betreft het gelijktijdigheidsgedrag is Fr_PrepareLPdu gespecificeerd als niet-re-entrant voor dezelfde hardware-eenheid (Non Reentrant for the same device) [SWS_Fr_00107]. Een parallelle of onderbrekende aanroep voor dezelfde controllerindex Fr_CtrlIdx moet daarom dwingend door de oproeper worden vermeden.

Retourwaarden en foutafhandeling

De functie heeft het service-ID 0x1f en meldt haar status via het retourtype Std_ReturnType terug [SWS_Fr_00107]:

• E_OK: De API-aanroep is succesvol beëindigd [SWS_Fr_00107].
• E_NOT_OK: De API-aanroep is wegens opgetreden fouten voortijdig afgebroken [SWS_Fr_00107]. Specifieke DET- of DEM-foutcodes worden in het onderhavige specificatie-uittreksel niet gedefinieerd.

Gebruik en parameters

De synchrone functie Fr_ReconfigLPdu maakt de dynamische herconfiguratie van een FlexRay-LPDU tijdens runtime mogelijk [SWS_Fr_00524]. Beschikbaar gesteld via de header Fr.h, adresseert de aanroep via Fr_CtrlIdx de desbetreffende FlexRay-controller en via Fr_LPduIdx de unieke identificator van het frame AUTOSAR_SWS_FlexRayDriver p. 65.

De volgende doelparameters worden bij de herconfiguratie doorgegeven [SWS_Fr_00524]:

• Fr_FrameId en Fr_ChnlIdx: Vastlegging van de nieuwe frame-ID en het communicatiekanaal.
• Fr_CycleRepetition en Fr_CycleOffset: Configuratie van de cyclusfiltering voor de LPDU.
• Fr_PayloadLength en Fr_HeaderCRC: Nuttige datalengte in bytes en de bijbehorende header-CRC van het frame.

Concurrency en retourwaarden

De service is niet-re-entrant voor dezelfde controller (Non Reentrant for the same device) [SWS_Fr_00524]. Bij aanroepen voor verschillende FlexRay-controllerinstanties is re-entrantie daarentegen vermoedelijk wel aanwezig (interpretatie). Vraag Q-85908ef4796c80c7 (open) Bij succesvolle herconfiguratie retourneert de aanroep E_OK; mislukt de herconfiguratie als gevolg van fouten, dan wordt E_NOT_OK geretourneerd AUTOSAR_SWS_FlexRayDriver p. 65.

Gebruik

De synchrone driverfunctie Fr_DisableLPdu dient ertoe om de hardwarebron van een FlexRay-LPdu voor verzenden of ontvangen te deactiveren ([SWS_Fr_00539]). De interface wordt via het headerbestand Fr.h beschikbaar gesteld en is toegewezen aan het service-ID 0x26 ([SWS_Fr_00539]).

Voor de functieaanroep moeten twee verplichte parameters worden doorgegeven ([SWS_Fr_00539]):

• Fr_CtrlIdx: De index van de FlexRay-communication-controller binnen de drivercontext.
• Fr_LPduIdx: De unieke index ter identificatie van het betreffende FlexRay-frame resp. de LPdu.

Als retourwaarde levert de functie de status Std_ReturnType op ([SWS_Fr_00539]). De waarde E_OK geeft een succesvol beëindigde aanroep aan, terwijl E_NOT_OK wordt geretourneerd indien de aanroep door een fout is afgebroken.

Foutafhandeling

In de onderhavige specificatie zijn geen specifieke foutcodes en geen meldingen aan DET of DEM voor deze service gedefinieerd; het foutgedrag uit zich direct in de retourwaarde E_NOT_OK ([SWS_Fr_00539]).

Gelijktijdigheid en beperkingen

Wat re-entrantie betreft is Fr_DisableLPdu geclassificeerd als niet-re-entrant voor hetzelfde apparaat (Non Reentrant for the same device) ([SWS_Fr_00539]). Oproepers moeten er daarom voor zorgen dat gelijktijdige aanroepen voor dezelfde controller worden gesynchroniseerd.

De synchrone functie Fr_CancelAbsoluteTimer dient voor het ordelijk stoppen van een actieve absolute timer op een FlexRay Communication Controller ([SWS_Fr_00095]). Deze wordt beschikbaar gesteld via het headerbestand Fr.h en heeft de service-ID 0x13 ([SWS_Fr_00095]).

Parameters en retourwaarde

• Fr_CtrlIdx: Geeft de index van de betreffende FlexRay Communication Controller in de context van het FlexRay-stuurprogramma door ([SWS_Fr_00095]).
• Fr_AbsTimerIdx: Bepaalt de index van de te stoppen absolute timer in de context van de geselecteerde FlexRay-controller ([SWS_Fr_00095]).
• Retourwaarde: Levert via het type Std_ReturnType de status E_OK bij succesvolle uitvoering of E_NOT_OK indien de aanroep wegens fouten is afgebroken ([SWS_Fr_00095]).

Gelijktijdigheid en beperkingen

Wat betreft gelijktijdigheid is de interface voor hetzelfde apparaat gedefinieerd als niet-re-entrant (“Non Reentrant for the same device”) ([SWS_Fr_00095]). Oproepende lagen moeten ervoor zorgen dat er geen concurrerende of onderbrekende toegangen voor dezelfde controller plaatsvinden. Interpretatie: Bij verschillende controllers is de uitvoering daarentegen vermoedelijk re-entrant toegestaan. Vraag Q-01203b0b28193021 (open)

De synchrone functie Fr_EnableAbsoluteTimerIRQ dient voor de activering van de interruptlijn van een absolute timer binnen een FlexRay-Communication-Controller [SWS_Fr_00034]. De service wordt beschikbaar gesteld via het headerbestand Fr.h en heeft de service-ID 0x15 [SWS_Fr_00034].

Bij de aanroep verwacht de interface twee ingangsparameters [SWS_Fr_00034]:

• Fr_CtrlIdx: Index van de FlexRay-Communication-Controller in de context van de FlexRay-driver [SWS_Fr_00034].
• Fr_AbsTimerIdx: Index van de absolute timer in de context van de geadresseerde FlexRay-controller [SWS_Fr_00034].

De retourwaarde van het type Std_ReturnType signaleert het resultaat van de uitvoering [SWS_Fr_00034]:

• E_OK: de API-aanroep is met succes voltooid [SWS_Fr_00034].
• E_NOT_OK: De functieaanroep is afgebroken als gevolg van fouten [SWS_Fr_00034].

Met betrekking tot de gelijktijdigheid is de functie gespecificeerd als niet-reentrant voor hetzelfde apparaat (“Non Reentrant for the same device”) [SWS_Fr_00034]. Dit vereist dat gelijktijdige aanroepen voor dezelfde controllerinstantie dwingend moeten worden vermeden; vermoedelijk is een parallelle aanroep voor verschillende controllerinstanties echter toegestaan. Vraag Q-d7e594a84357e129 (open) Specifieke foutcodes voor ontwikkelings- of productiefouten (DET/DEM) worden niet vermeld in de functiebeschrijving; opgetreden fouten leiden direct tot teruggave van E_NOT_OK [SWS_Fr_00034].

De synchrone functie Fr_AckAbsoluteTimerIRQ behoort tot de module van het FlexRay-stuurprogramma (Fr) in het AUTOSAR Classic Platform en dient voor het terugstellen van de interruptvoorwaarde van een absolute timer [SWS_Fr_00036]. De declaratie van de interface wordt via het headerbestand Fr.h beschikbaar gesteld en is toegewezen aan de hexadecimale service-ID 0x17 [SWS_Fr_00036].

Voor een eenduidige adressering van de timer verwacht de functie twee invoerparameters van het type uint8, terwijl er geen invoer-/uitvoer- of zuivere uitvoerparameters aanwezig zijn [SWS_Fr_00036]:

• Fr_CtrlIdx: Geeft de index van de FlexRay Communication Controller (CC) binnen de context van het FlexRay-stuurprogramma door [SWS_Fr_00036].
• Fr_AbsTimerIdx: Duidt de index aan van de absolute timer binnen de context van de betreffende FlexRay Communication Controller [SWS_Fr_00036].

Het resultaat van de functie-uitvoering wordt teruggemeld via de statuswaarde van het type Std_ReturnType. Werd de aanroep met succes beëindigd, dan geeft de functie E_OK terug [SWS_Fr_00036]. Treden tijdens de uitvoering fouten op, dan breekt de functieaanroep voortijdig af en levert in plaats daarvan E_NOT_OK [SWS_Fr_00036].

Wat betreft het gedrag bij gelijktijdigheid is de service geclassificeerd als niet-re-entrant voor hetzelfde apparaat (Non Reentrant for the same device) [SWS_Fr_00036]. Aanroepen voor dezelfde controllerinstantie moeten daarom synchroon plaatsvinden en mogen niet gelijktijdig overlappend worden uitgevoerd [SWS_Fr_00036].

De synchrone functie Fr_DisableAbsoluteTimerIRQ dient in het FlexRay-stuurprogramma om de interruptlijn van een absolute timer gericht te deactiveren [SWS_Fr_00035]. Als invoerparameters verwacht de interface de controllerindex Fr_CtrlIdx voor adressering van de betreffende FlexRay-communicatiecontroller (CC) in de stuurprogrammacontext en Fr_AbsTimerIdx voor identificatie van de absolute timer binnen deze controller [SWS_Fr_00035]. De declaratie van de functie wordt via het headerbestand Fr.h beschikbaar gesteld [SWS_Fr_00035].

Het resultaat van de uitvoering wordt synchroon via het retourtype Std_ReturnType aan de oproeper doorgegeven [SWS_Fr_00035]. Kon de service correct en met succes worden beëindigd, dan levert deze E_OK terug [SWS_Fr_00035]. Komt het tijdens de verwerking daarentegen tot fouten, dan breekt de functie het proces af en signaleert dit door middel van de retourwaarde E_NOT_OK [SWS_Fr_00035]. Concrete ontwikkelings- of runtimefouten (DET/DEM) zijn niet vermeld in het specificatie-element, zodat fouttoestanden primair aan de hand van de retourwaarde moeten worden herkend en afgehandeld [SWS_Fr_00035].

Wat betreft gelijktijdigheid is Fr_DisableAbsoluteTimerIRQ gedefinieerd als niet-re-entrant voor hetzelfde apparaat (same device) [SWS_Fr_00035]. Daarom mogen meerdere aanroepen voor dezelfde controllerindex niet gelijktijdig plaatsvinden en moeten deze aan oproeperszijde worden gesynchroniseerd, terwijl parallelle toegang tot verschillende controllers is toegestaan [SWS_Fr_00035].

De synchrone functie Fr_ReadCCConfig leest een specifieke FlexRay-protocolconfiguratieparameter van een controller rechtstreeks uit de moduleconfiguratie van de FlexRay-driver [SWS_Fr_00651]. De interface wordt gedeclareerd via de header Fr.h en heeft het service-ID 0x2e [SWS_Fr_00651].

Parameters en retourwaarden

• Fr_CtrlIdx: Bepaalt de index van de desbetreffende FlexRay Communication Controller in de drivercontext [SWS_Fr_00651].
• Fr_ConfigParamIdx: Identificeert de uit te lezen parameter via gedefinieerde macro's van het formaat FR_CIDX_<config_parameter_name> [SWS_Fr_00651].
• Fr_ConfigParamValuePtr: Pointer naar het geheugenadres van het type uint32 waarnaar de uitgelezen waarde wordt geschreven [SWS_Fr_00651].
• Retourwaarde: Levert E_OK op bij succesvolle uitvoering of E_NOT_OK in geval van een fout [SWS_Fr_00651].

Gelijktijdigheid en foutgedrag

De functie is ontworpen als niet-re-entrant voor dezelfde controller („Non Reentrant for the same device”) [SWS_Fr_00651]. Gelijktijdige aanroepen voor verschillende controllerinstanties zijn daarom vermoedelijk toegestaan. Vraag Q-b5e4172654514747 (open) Specifieke DET- of DEM-fouten worden in de interfacedefinitie niet genoemd; fouttoestanden leiden tot afbreken onder teruggave van E_NOT_OK [SWS_Fr_00651]. De aanroeper dient er vermoedelijk voor te zorgen dat Fr_ConfigParamValuePtr naar een geldig geheugengebied verwijst.

Het opsommingstype Fr_SlotModeType maakt deel uit van de interfacedefinitie van het FlexRay-stuurprogramma in AUTOSAR Classic en wordt beschikbaar gesteld via de header Fr_GeneralTypes.h [SWS_Fr_00506]. De typedefinitie verwijst formeel naar het type T_SlotMode uit de FlexRay-protocolspecificatie, waar dit is beschreven in het hoofdstuk over de Protocol Operation Control (POC-status) [SWS_Fr_00506].

De opsomming specificeert de toestand van de slotverwerking van de controller aan de hand van drie vast gedefinieerde waarden [SWS_Fr_00506]:

• FR_SLOTMODE_KEYSLOT (waarde 0x00): Vormt de weergave van de literal KEYSLOT van de formele typedefinitie T_SlotMode [SWS_Fr_00506].
• FR_SLOTMODE_ALL_PENDING (waarde 0x01): Vormt de weergave van de literal ALL_PENDING van de formele typedefinitie T_SlotMode [SWS_Fr_00506].
• FR_SLOTMODE_ALL (waarde 0x02): Vormt de weergave van de literal ALL van de formele typedefinitie T_SlotMode [SWS_Fr_00506].

Bij gebruik met controllers die conform zijn aan de oudere standaard FlexRay 2.1 Rev A dient rekening te worden gehouden met een afwijkende naamgeving: in plaats van de literal KEYSLOT treedt hier de literal SINGLESLOT op [SWS_Fr_00506]. Interpretatie: Op stuurprogramma- en softwareniveau dient het type er vermoedelijk toe om te bepalen of de FlexRay-controller momenteel alleen sleutelslots (Key Slots) of alle slots voor de overdracht heeft vrijgegeven dan wel of er een dienovereenkomstige omschakeling op handen is. Vraag Q-f926c41c8a5d3380 (open)

Gebruik

Het opsommingstype Fr_ErrorModeType representeert de foutmodi van de FlexRay Protocol Operation Control (POC) en wordt beschikbaar gesteld via het headerbestand Fr_GeneralTypes.h [SWS_Fr_00507]. De opsomming definieert de toestanden van het foutbewakingsmechanisme van de communicatiecontroller en verwijst naar de formele typedefinitie T_ErrorMode in de FlexRay-POC-status [SWS_Fr_00507].

Het waardebereik omvat conform [SWS_Fr_00507] drie toestanden:

• FR_ERRORMODE_ACTIVE (0x00): Representeert de literal ACTIVE van de formele typedefinitie T_ErrorMode en kenmerkt de foutvrije toestand resp. het normale bedrijf van de communicatiecontroller.
• FR_ERRORMODE_PASSIVE (0x01): Komt overeen met de literal PASSIVE van de formele typedefinitie T_ErrorMode, waarbij fouten op de bus zijn geregistreerd en de communicatie beperkt kan zijn.
• FR_ERRORMODE_COMM_HALT (0x02): Vormt de weergave van de literal COMM_HALT van de formele typedefinitie T_ErrorMode wanneer de buscommunicatie wegens ernstige fouttoestanden is gestopt.

Integratie en randvoorwaarden

Interpretatie: Het type dient vermoedelijk vooral als retourwaarde of statusparameter in opvraagfuncties van het FlexRay-stuurprogramma om aan bovenliggende softwarelagen de toestand van de controller over te brengen. Vraag Q-e4d6ae534d1dfa2c (open) Aangezien [SWS_Fr_00507] uitsluitend de datastructuur specificeert, bestaan er op typeniveau geen zelfstandige foutafhandelingen via DET of DEM en evenmin directe vereisten aan de re-entrantie of gelijktijdigheid.

Het opsommingstype Fr_WakeupStatusType wordt beschikbaar gesteld via het headerbestand Fr_GeneralTypes.h en representeert de wake-up-status van het FlexRay-stuurprogramma conform de formele definitie T_WakeupStatus uit de POC-status [SWS_Fr_00508].

Gebruik en waardebereik

Het type representeert de verschillende toestanden en gebeurtenissen tijdens een FlexRay-wake-upprocedure en omvat zeven specifieke opsommingswaarden [SWS_Fr_00508]:

• FR_WAKEUP_UNDEFINED (0x00): Komt overeen met de literal UNDEFINED van de formele typedefinitie [SWS_Fr_00508].
• FR_WAKEUP_RECEIVED_HEADER (0x01): Kenmerkt de ontvangst van een wake-up-header (literal RECEIVED_HEADER) [SWS_Fr_00508].
• FR_WAKEUP_RECEIVED_WUP (0x02): Representeert het ontvangen wakeup-patroon (literaal RECEIVED_WUP) [SWS_Fr_00508].
• FR_WAKEUP_COLLISION_HEADER (0x03): Geeft een botsing bij een ontvangen header aan (literaal COLLISION_HEADER) [SWS_Fr_00508].
• FR_WAKEUP_COLLISION_WUP (0x04): Signaleert een botsing tijdens een wakeup-patroon (literaal COLLISION_WUP) [SWS_Fr_00508].
• FR_WAKEUP_COLLISION_UNKNOWN (0x05): Beschrijft een botsing met onbekende oorzaak (literaal COLLISION_UNKNOWN) [SWS_Fr_00508].
• FR_WAKEUP_TRANSMITTED (0x06): Bevestigt het succesvol verzenden van het wakeup-signaal (literaal TRANSMITTED) [SWS_Fr_00508].

Interactie en beperkingen

Interpretatie: het type dient vermoedelijk primair als statusparameter van driverfuncties om bovenliggende modules een nauwkeurige diagnose van de kanaal- en ontwaaktoestand mogelijk te maken. Vraag Q-48907418bc3729a1 (open) Aangezien de specificatie geen specifieke foutcodes of gelijktijdigheidsbeperkingen voor het type zelf definieert, is het gebruik onderworpen aan de aanroepconventies van de desbetreffende opvragende API-functies [SWS_Fr_00508].

Het enumeratietype Fr_StartupStateType wordt conform [SWS_Fr_00509] via het headerbestand Fr_GeneralTypes.h beschikbaar gesteld en beeldt de opstarttoestanden van de FlexRay-protocolcontroller (POC-status) af op gestandaardiseerde waarden. De definitie verwijst naar de formele typedefinitie T_StartupState uit hoofdstuk 2.2.1.3 van de specificatie.

Het waardebereik omvat elf discrete toestanden die het verloop van het opstarten van het protocol afbeelden:

• FR_STARTUP_UNDEFINED (0x00): Representeert een ongedefinieerde opstarttoestand.
• FR_STARTUP_COLDSTART_LISTEN (0x01) tot FR_STARTUP_COLDSTART_GAP (0x09): Representeren de fasen van de koudestart inclusief luisterfase, consistentiecontrole, botsingsoplossing en toetreden (Coldstart Join).
• FR_STARTUP_INTEGRATION_LISTEN (0x06), FR_STARTUP_INITIALIZE_SCHEDULE (0x07) en FR_STARTUP_INTEGRATION_CONSISTENCY_CHECK (0x08): Representeren integratie- en initialisatiestappen in het tijdschema.
• FR_STARTUP_EXTERNAL_STARTUP (0x0A): Representeert het extern gestuurde opstarten.

Integrerende softwaremodules gebruiken dit type (interpretatie: primair voor statusopvraag of bewaking van het opstarten van de controller). Vraag Q-7d07faa6c48d4e58 (open) Aangezien Fr_StartupStateType een zuivere typedefinitie is, worden er geen foutcodes of foutmeldingen direct gegenereerd; verwerkers moeten er echter rekening mee houden dat waarden buiten het bereik van 0x00 tot 0x0A niet gespecificeerd zijn.

Het datatype Fr_POCStatusType is gespecificeerd als datastructuur en wordt via het headerbestand Fr_GeneralTypes.h beschikbaar gesteld [SWS_Fr_00510]. De formele definitie verwijst naar de beschrijving van het type T_POCStatus in hoofdstuk 2.2.1.3 (POC status) van de FlexRay-protocolspecificatie [SWS_Fr_00510].

Gebruik en structuuropbouw

De structuur aggregeert de actuele bedrijfs- en protocoltoestand van de FlexRay Protocol Operation Control (POC) [SWS_Fr_00510]. Deze is opgebouwd uit de volgende elementen:

• State (type Fr_POCStateType) en StartupState (type Fr_StartupStateType) voor het aangeven van de actuele POC-toestand evenals de opstartstatus [SWS_Fr_00510].
• ErrorMode (type Fr_ErrorModeType) en Freeze (type boolean) ter aanduiding van de foutmodus en een controllerstop [SWS_Fr_00510].
• SlotMode (type Fr_SlotModeType) en WakeupStatus (type Fr_WakeupStatusType) voor de slotmodus en de wekstatus [SWS_Fr_00510].
• CHIHaltRequest, CHIReadyRequest en ColdstartNoise (elk boolean) voor het signaleren van host-interfaceverzoeken resp. lijnruis tijdens de koudestart [SWS_Fr_00510].

Gelijktijdigheid en integratie

Interpretatie: Aangezien Fr_POCStatusType een zuivere datastructuur zonder eigen functionele logica is, fungeert deze vermoedelijk primair als uitvoerparameter bij statusopvragingen van de FlexRay-hardware. Vraag Q-960f2475ff1068fc (open) Wanneer meerdere taken of softwarelagen toegang hebben tot instanties van deze structuur, moeten aanroepers zelfstandig zorgen voor een passende synchronisatie om een consistent uitlezen van de samenhangende deeltoestanden te waarborgen [SWS_Fr_00510].

Het opsommingstype Fr_TxLPduStatusType dient in het AUTOSAR-Classic-platform om vast te stellen of een FlexRay-LPdu (Link Layer Protocol Data Unit) succesvol is verzonden of niet [SWS_Fr_00511]. De typedefinitie wordt via het headerbestand Fr_GeneralTypes.h beschikbaar gesteld voor softwaremodules [SWS_Fr_00511].

Het waardebereik van de enumeratie omvat drie eenduidige statustoestanden voor zendprocessen [SWS_Fr_00511]:

• FR_TRANSMITTED (0x00): De LPdu is succesvol via de bus verzonden [SWS_Fr_00511].
• FR_TRANSMITTED_CONFLICT (0x01): Tijdens de verzending is een conflict opgetreden [SWS_Fr_00511].
• FR_NOT_TRANSMITTED (0x02): De LPdu is niet verzonden [SWS_Fr_00511].

Wat betreft het samenspel en de aanroepcontext zal deze statuswaarde typisch door bovenliggende lagen worden gebruikt om de zendbuffertoestand in de FlexRay-driver op te vragen (interpretatie). Vraag Q-347a88512db1f006 (open) Specifieke foutcodes, foutafhandelingsroutines en DET- of DEM-meldingen zijn voor dit datatype in de specificaties niet voorzien, aangezien het om een zuivere typedeclaratie gaat [SWS_Fr_00511].

Het enumeratietype Fr_RxLPduStatusType maakt deel uit van de AUTOSAR-Classic-module Fr en wordt beschikbaar gesteld via het headerbestand Fr_GeneralTypes.h [SWS_Fr_00512]. Het dient om vast te stellen of een L-PDU (FlexRay-Link-Layer-PDU) is ontvangen of niet [SWS_Fr_00512].

Het type definieert drie discrete statuswaarden voor de beoordeling van de ontvangststatus [SWS_Fr_00512]:

• FR_RECEIVED (0x00): De L-PDU is succesvol ontvangen [SWS_Fr_00512].
• FR_NOT_RECEIVED (0x01): De L-PDU is niet ontvangen [SWS_Fr_00512].
• FR_RECEIVED_MORE_DATA_AVAILABLE (0x02): De L-PDU is ontvangen en er zijn verdere instanties van deze L-PDU beschikbaar, zoals optreedt bij het gebruik van ontvangst-FIFO's [SWS_Fr_00512].

Bij ontvangst via bufferstructuren onderscheidt het type niet alleen de aanwezigheid van ontvangen gegevens, maar markeert bij FIFO-bedrijf bovendien de aanwezigheid van verdere instanties [SWS_Fr_00512]. Dit signaleert de aanroeper vermoedelijk dat na het uitlezen van de huidige instantie direct verdere gegevens uit de FIFO kunnen worden opgehaald [SWS_Fr_00512]. Vraag Q-0ab7cac72ff7f549 (open)

De structuur Fr_SlotAssignmentType dient voor de opslag van toewijzingsinformatie van een FlexRay-frame aan een communicatiecyclus en een slot-ID [SWS_Fr_91002]. Deze is gedefinieerd in de header Fr_GeneralTypes.h en vat alle adresseringsparameters samen die vereist zijn voor het verzenden of ontvangen van een frame op het FlexRay-kanaal [SWS_Fr_91002].

De structuur omvat de volgende elementen [SWS_Fr_91002]:

• Cycle (type uint8): Duidt de cyclus aan waarin het FlexRay-frame wordt verzonden of ontvangen [SWS_Fr_91002].
• SlotId (type uint16): Duidt het unieke slot-ID van het frame binnen het FlexRay-communicatieschema aan [SWS_Fr_91002].
• channelId (type Fr_ChannelType): Geeft het FlexRay-kanaal aan waarlangs de verzending of de ontvangst plaatsvindt [SWS_Fr_91002].

Aangezien Fr_SlotAssignmentType een zuivere datastructuur vertegenwoordigt, heeft deze geen eigen uitvoeringssemantiek zoals synchroniciteit of re-entrantie en activeert deze zelf geen DET- of DEM-foutmeldingen [SWS_Fr_91002]. De consistentie van de opgenomen waarden voor cyclus, slot en kanaal valt vermoedelijk onder de verantwoordelijkheid van de gebruikende driverfuncties (interpretatie). Vraag Q-77f88375e544e298 (open)