FlexRay Interface (FrIf)

De functie FrIf_Init dient voor de initialisatie van de FlexRay-interfacemodule ([SWS_FrIf_05003]). De aanroep vindt synchroon plaats en is gespecificeerd als niet-re-entrant (Non Reentrant) ([SWS_FrIf_05003]).

Parameters en retourwaarden

• FrIf_ConfigPtr (ingangsparameter): Basispointer naar de configuratiestructuur van de FlexRay-interface ([SWS_FrIf_05003]).
• Retourwaarde: void – de functie levert geen retourwaarde terug ([SWS_FrIf_05003]).

Beperkingen en aanroepvoorwaarden

Aangezien FrIf_Init niet-re-entrant is, mag de functie op geen enkel moment parallel of onderbrekend door dezelfde of een andere thread respectievelijk taak opnieuw worden aangeroepen ([SWS_FrIf_05003]). De aanroep moet plaatsvinden in de systeeminitialisatiecontext, voordat reguliere services van de FlexRay-interface worden aangesproken.

De synchrone functie FrIf_ControllerInit dient voor de initialisatie van een FlexRay Communication Controller (FlexRay CC) [SWS_FrIf_05004]. Deze is beschikbaar via het headerbestand FrIf.h en wordt geïdentificeerd via het service-ID 0x03 [SWS_FrIf_05004].

Via de invoerparameter FrIf_CtrlIdx van het datatype uint8 wordt de index van de te adresseren FlexRay-controller doorgegeven [SWS_FrIf_05004]. Verdere in- of uitvoerparameters bestaan niet voor deze interface [SWS_FrIf_05004].

De retourwaarde is van het type Std_ReturnType en meldt de status van de initialisatie terug aan de aanroeper [SWS_FrIf_05004]:

• E_OK: De aanroep van de API-service van de onderliggende FlexRay-driver was succesvol en leverde E_OK op [SWS_FrIf_05004].
• E_NOT_OK: De API-service van de FlexRay-driver heeft E_NOT_OK geretourneerd of er is in de ontwikkelingsmodus een fout vastgesteld [SWS_FrIf_05004].

Met betrekking tot de gelijktijdigheid is FrIf_ControllerInit re-entrant voor verschillende controller-indices (FrIf_CtrlIdx), maar niet-re-entrant voor identieke waarden van FrIf_CtrlIdx [SWS_FrIf_05004]. Gelijktijdige aanroepen voor dezelfde controller moeten daarom door het totale systeem worden voorkomen.

Gebruik

De functie FrIf_EnableAbsoluteTimerIRQ vormt een synchrone service met de service-ID 0x1d, die beschikbaar wordt gesteld via het headerbestand FrIf.h [SWS_FrIf_05025]. Deze fungeert als wrapper rond de interface Fr_EnableAbsoluteTimerIRQ() van de FlexRay-driver voor het activeren van de interrupt van een absolute timer [SWS_FrIf_05025].

De aanroep vereist twee ingangsparameters [SWS_FrIf_05025]:

• FrIf_CtrlIdx: Index van de aan te spreken FlexRay-communicatiecontroller (FlexRay CC) [SWS_FrIf_05025].
• FrIf_AbsTimerIdx: Index van de te activeren absolute timer op de geadresseerde controller [SWS_FrIf_05025].

Retourwaarden en foutafhandeling

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

• E_OK: De aanroep van de onderliggende driverservice is geslaagd en heeft E_OK opgeleverd [SWS_FrIf_05025].
• E_NOT_OK: De driverfunctie heeft E_NOT_OK geretourneerd of er is in de ontwikkelingsmodus (Development Mode) een fout gedetecteerd [SWS_FrIf_05025].

Gelijktijdigheid en re-entrantie

Wat de aanroepcontext betreft, is FrIf_EnableAbsoluteTimerIRQ niet reentrant voor dezelfde FlexRay-controller, maar mag deze voor verschillende FlexRay-controllers wel reentrant worden aangeroepen [SWS_FrIf_05025].

De synchrone interfacefunctie FrIf_AckAbsoluteTimerIRQ kapselt als wrapper de API-aanroep van de driverfunctie Fr_AckAbsoluteTimerIRQ() van de FlexRay-driver in [SWS_FrIf_05029]. Deze heeft de service-ID 0x21, wordt beschikbaar gesteld via de header FrIf.h en dient voor het bevestigen van een interruptverzoek voor een absolute timer van een FlexRay Communication Controller.

Bij de aanroep van de functie moeten twee invoerparameters worden meegegeven [SWS_FrIf_05029]:

• FrIf_CtrlIdx: Index van de te adresseren FlexRay Communication Controller (CC).
• FrIf_AbsTimerIdx: Index van de specifieke absolute timer waarvan de interrupt moet worden bevestigd.

De functie levert een retourwaarde van het type Std_ReturnType op voor de evaluatie van het resultaat [SWS_FrIf_05029]:

• E_OK: De aanroep van de driver-API Fr_AckAbsoluteTimerIRQ() is met succes uitgevoerd.
• E_NOT_OK: De FlexRay-driver meldde bij de aanroep E_NOT_OK, of er werd een fout gedetecteerd in de ontwikkelingsmodus (Development Mode).

Wat het gedrag bij gelijktijdigheid betreft, werkt de functie synchroon. Aanroepen voor verschillende FlexRay CC's zijn reentrant, terwijl gelijktijdige aanroepen voor dezelfde FlexRay CC niet reentrant zijn en moeten worden vermeden [SWS_FrIf_05029].

De functie FrIf_StartCommunication fungeert als inkapseling van de FlexRay-driverfunctie Fr_StartCommunication() en zet het starten van de communicatie van een geadresseerde FlexRay-communicatiecontroller in gang [SWS_FrIf_05005].

Gebruik en aanroepcontext

De interface is gedeclareerd via de header FrIf.h en heeft het service-ID 0x04 [SWS_FrIf_05005]. De aanroep wordt asynchroon afgehandeld [SWS_FrIf_05005]. Als enige invoerparameter dient FrIf_CtrlIdx (type uint8), die de index van de aan te sturen FlexRay-communicatiecontroller vastlegt; in-/uitvoer- of zuivere uitvoerparameters bestaan niet [SWS_FrIf_05005].

Foutafhandeling en retourwaarden

De functie retourneert een statuscode van het type Std_ReturnType [SWS_FrIf_05005]:

• E_OK: De aanroep van de onderliggende API-service in de FlexRay-driver verliep succesvol en leverde E_OK op [SWS_FrIf_05005].
• E_NOT_OK: De API-service van de driver heeft E_NOT_OK gemeld of er is tijdens de uitvoering in de ontwikkelmodus (Development Mode) een fout gedetecteerd [SWS_FrIf_05005].

Gelijktijdigheid en beperkingen

Wat betreft re-entrantie is FrIf_StartCommunication re-entrant voor van elkaar afwijkende controller-indices (FrIf_CtrlIdx), maar niet-re-entrant voor identieke controllerwaarden [SWS_FrIf_05005]. Oproepende modules moeten daarom bij gelijktijdige toegangen waarborgen dat er geen concurrerende aanroepen voor dezelfde controller plaatsvinden.

De functie FrIf_HaltCommunication (service-ID 0x05) vormt in de FlexRay Interface (FrIf) een wrapper voor de aanroep van de driver-API-functie Fr_HaltCommunication() en wordt via de header FrIf.h gedeclareerd [SWS_FrIf_05006]. De service wordt met asynchrone semantiek uitgevoerd [SWS_FrIf_05006]. Als enige parameter wordt de invoerwaarde FrIf_CtrlIdx meegegeven, die de index van de telkens aan te spreken FlexRay Communication Controller specificeert; in-/uitvoer- of zuivere uitvoerparameters zijn voor deze service niet gedefinieerd [SWS_FrIf_05006].

De retourwaarde is van het type Std_ReturnType en signaleert het resultaat van de aanroep [SWS_FrIf_05006]:

• E_OK: De aanroep van de API-service in de FlexRay-driver was succesvol en leverde E_OK op [SWS_FrIf_05006].
• E_NOT_OK: De API-aanroep van de FlexRay-driver heeft E_NOT_OK geretourneerd of er is in de ontwikkelmodus (Development Mode) een fout gedetecteerd [SWS_FrIf_05006].

Met betrekking tot gelijktijdigheid is FrIf_HaltCommunication re-entrant voor verschillende waarden van de controller-index FrIf_CtrlIdx, maar niet-re-entrant bij identieke waarden voor FrIf_CtrlIdx [SWS_FrIf_05006]. Gelijktijdige of onderbrekende aanroepen voor dezelfde controller zijn bijgevolg niet toegestaan en moeten in de context van de aanroeper worden voorkomen.

Gebruik en aanroepcontext

De synchrone interfacefunctie FrIf_AbortCommunication fungeert als directe wrapper voor de API-functie Fr_AbortCommunication() van de FlexRay-driver [SWS_FrIf_05007]. Deze is in het headerbestand FrIf.h gedeclareerd en bezit het service-ID 0x06 [SWS_FrIf_05007].

Via de ingangsparameter FrIf_CtrlIdx wordt de index van de aan te spreken FlexRay Communication Controller aangegeven [SWS_FrIf_05007]. Aanvullende in- of uitvoerparameters zijn voor deze interface niet gedefinieerd [SWS_FrIf_05007].

Retourwaarden en foutafhandeling

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

• E_OK: De aanroep van de API-service van de FlexRay-driver was succesvol en heeft E_OK teruggegeven [SWS_FrIf_05007].
• E_NOT_OK: De API-service van de FlexRay-driver heeft E_NOT_OK geretourneerd of er is een fout gedetecteerd in de ontwikkelingsmodus [SWS_FrIf_05007].

Gelijktijdigheid en beperkingen

De uitvoering van FrIf_AbortCommunication is synchroon [SWS_FrIf_05007]. De functie is re-entrant voor verschillende waarden van FrIf_CtrlIdx, maar niet-re-entrant voor identieke controllerindices [SWS_FrIf_05007].

Gebruik en aanroep

De synchrone functie FrIf_SetState verzoekt om een toestandsovergang in de toestandsmachine van het FlexRay-interface [SWS_FrIf_05174]. Als parameters worden de clusterindex FrIf_ClstIdx en de gewenste overgang FrIf_StateTransition meegegeven. De functie retourneert E_OK wanneer de aanroep succesvol is uitgevoerd en de toestandsverandering is geaccepteerd; in het geval van een fout wordt E_NOT_OK geretourneerd [SWS_FrIf_05174].

Foutafhandeling en randvoorwaarden

De functie is gedefinieerd als niet-reentrant (Non Reentrant) [SWS_FrIf_05174]. Als ontwikkelingscontrole is ingeschakeld (FrIfDevErrorDetect == ON) en parameter FrIf_StateTransition een ongeldige waarde bevat, meldt de functie foutcode FRIF_E_INV_FRIF_STATE via Det_ReportError aan de DET-module [SWS_FrIf_05037].

Samenhang bij offline-overgangen

Wanneer FrIf_SetState wordt aangeroepen met overgangsparameter FRIF_STATE_OFFLINE, controleert het FlexRay-interface voor elke PDU de teller TxConfCounter [SWS_FrIf_05501]. Als deze waarde voor een PDU groter is dan 0, informeert de module de bovenliggende laag via de aanroep <UL>_TxConfirmation(id, E_NOT_OK) over het uitblijven van de openstaande bevestiging [SWS_FrIf_05501].

De functie FrIf_SendWUP (service-ID 0x0a) van de module FrIf is beschikbaar via het headerbestand FrIf.h en dient als interface-wrapper voor de aanroep van de API-functie Fr_SendWUP() van de onderliggende FlexRay-driver [SWS_FrIf_05011].

Gebruik en parameters

De service wordt asynchroon uitgevoerd [SWS_FrIf_05011]. Als enige overdrachtsparameter dient de invoerparameter FrIf_CtrlIdx van het type uint8, die de index van de te adresseren FlexRay Communication Controller (FlexRay CC) specificeert [SWS_FrIf_05011]. Er worden geen inout- of out-parameters gebruikt [SWS_FrIf_05011].

Retourwaarden en foutafhandeling

Als retourwaarde levert de functie een status van het type Std_ReturnType [SWS_FrIf_05011]:

• E_OK: De aanroep van de API-service van de FlexRay-driver is succesvol uitgevoerd en heeft E_OK teruggemeld [SWS_FrIf_05011].
• E_NOT_OK: De aanroep van de API-service van de FlexRay-driver heeft E_NOT_OK geretourneerd of er is in de ontwikkelmodus (Development Mode) een fout gedetecteerd [SWS_FrIf_05011].

Gelijktijdigheid en re-entrantie

Wat betreft gelijktijdige toegang is FrIf_SendWUP re-entrant voor aanroepen met verschillende waarden voor FrIf_CtrlIdx, maar niet-re-entrant voor identieke waarden van FrIf_CtrlIdx [SWS_FrIf_05011].

Gebruik en werking

De functie FrIf_AllowColdstart dient als wrapper voor de FlexRay-driver-API Fr_AllowColdstart() conform [SWS_FrIf_05017]. Deze adresseert via de ingangsparameter FrIf_CtrlIdx de aan te spreken FlexRay Communication Controller (CC) [SWS_FrIf_05017]. De uitvoering van de functie is gespecificeerd als asynchroon [SWS_FrIf_05017].

Retourwaarden en foutafhandeling

De retourwaarde van het type Std_ReturnType weerspiegelt het resultaat van de uitvoering [SWS_FrIf_05017]:

• E_OK: De onderliggende API-service van de FlexRay-driver is succesvol aangeroepen en meldde E_OK terug [SWS_FrIf_05017].
• E_NOT_OK: De aanroep van de driver mislukte (retourwaarde E_NOT_OK) of er is in ontwikkelingsmodus (Development Mode) een fout gedetecteerd [SWS_FrIf_05017].

Interpretatie: Het detecteren van fouten in Development Mode zal vermoedelijk via de Default Error Tracer (DET)-module plaatsvinden, hoewel in het specificatie-uittreksel geen specifieke fout-ID's of controles zijn gedocumenteerd. Vraag Q-5dffd71d66731cc9 (open)

Gelijktijdigheid en beperkingen

Wat betreft reentrantie is FrIf_AllowColdstart niet reentrant voor identieke waarden van FrIf_CtrlIdx, maar mag deze wel parallel worden aangeroepen voor verschillende controller-indices [SWS_FrIf_05017]. Oproepers moeten er daarom voor zorgen dat gelijktijdige aanroepen voor dezelfde controller worden gesynchroniseerd. De interface wordt beschikbaar gesteld via de header FrIf.h [SWS_FrIf_05017].

De synchrone functie FrIf_Transmit verzoekt om de verzending van een PDU via de FlexRay-interface [SWS_FrIf_05033]. Deze accepteert het ID van de te verzenden PDU (TxPduId) en een pointer naar de structuur PduInfoPtr, die de PDU-lengte, datapointers en metadata levert [SWS_FrIf_05033].

Wat betreft concurrency en re-entry is FrIf_Transmit re-entrant voor verschillende PDU-ID's, maar niet re-entrant voor dezelfde PDU-ID [SWS_FrIf_05033]. De aanroep retourneert E_OK zodra het zendverzoek is geaccepteerd, en anders E_NOT_OK [SWS_FrIf_05033].

Een specifieke foutcontrole vindt plaats bij directe PDU's (Immediate PDU's), mits dynamische L-SDU-lengtes via de configuratieparameter FrIfAllowDynamicLSduLength op FALSE zijn gedeactiveerd [SWS_FrIf_05757]:

• De in PduInfoPtr doorgegeven lengte wordt gecontroleerd tegen de statisch geconfigureerde PDU-lengte [SWS_FrIf_05757].
• Als de lengteopgave niet overeenkomt, breekt FrIf_Transmit de verzending van de Immediate PDU af en retourneert E_NOT_OK [SWS_FrIf_05757].
• Voor zover ontwikkelingsdetectie (FrIfDevErrorDetect == ON) actief is, meldt de functie de ontwikkelingsfout FRIF_E_INV_PDULENGTH via Det_ReportError aan de DET-module [SWS_FrIf_05757].

De synchrone interface FrIf_SetTransceiverMode met service-ID 0x13 fungeert in de FlexRay-interface als wrapper voor de driverfunctie FrTrcv_SetTransceiverMode() van de FlexRay-transceiverdriver en is beschikbaar via het headerbestand FrIf.h [SWS_FrIf_05034]. Deze stelt hogere lagen in staat om de bedrijfsmodus van een transceiver in te stellen voor een specifieke FlexRay-controller en een specifiek kanaal [SWS_FrIf_05034].

Bij de aanroep moeten drie parameters worden doorgegeven: de controllerindex FrIf_CtrlIdx voor het adresseren van de FlexRay Communication Controller, de kanaalindex FrIf_ChnlIdx voor het bepalen van het FlexRay-kanaal binnen het geldigheidsbereik van de controller, en de gewenste transceivermodus FrIf_TrcvMode van het type FrTrcv_TrcvModeType [SWS_FrIf_05034]. Er bestaan noch invoer-/uitvoer- noch uitvoerparameters [SWS_FrIf_05034]. Voor de parameter FrIf_ChnlIdx geldt het bindende voorschrift dat de enumeratiewaarde FR_CHANNEL_AB onder geen beding mag worden gebruikt [SWS_FrIf_05034].

De functie is gespecificeerd als re-entrant en geeft de moduswijziging synchroon door aan de transceiverdriver [SWS_FrIf_05034]. Als resultaat levert deze de status Std_ReturnType op: deze meldt E_OK wanneer de aanroep van de API-dienst in de transceiverdriver met succes E_OK heeft opgeleverd; als deze driveraanroep mislukt en E_NOT_OK oplevert, wordt eveneens E_NOT_OK geretourneerd [SWS_FrIf_05034].

De synchrone functie FrIf_ClearTransceiverWakeup (service-ID 0x18) fungeert als wrapper binnen de FlexRay-interface en kapselt de aanroep van de API-functie FrTrcv_ClearTransceiverWakeup() van de FlexRay-transceiverdriver in [SWS_FrIf_05039]. De interface is beschikbaar via het headerbestand FrIf.h [SWS_FrIf_05039].

Bij de aanroep verwacht de functie precies twee invoerparameters [SWS_FrIf_05039]:

• FrIf_CtrlIdx: Index van de te adresseren FlexRay Communication Controller [SWS_FrIf_05039].
• FrIf_ChnlIdx: Index van het aan te spreken FlexRay-kanaal binnen het geldigheidsbereik van de controller FrIf_CtrlIdx [SWS_FrIf_05039].

Verdere parameters (inout of out) zijn voor de functie niet gedefinieerd [SWS_FrIf_05039].

Met betrekking tot concurrency en randvoorwaarden is de functie geclassificeerd als reentrant [SWS_FrIf_05039]. Als essentiële functionele beperking schrijft de specificatie voor dat de enumeratiewaarde FR_CHANNEL_AB voor de parameter FrIf_ChnlIdx niet mag worden gebruikt [SWS_FrIf_05039].

Het resultaat van de bewerking wordt synchroon geretourneerd als Std_ReturnType en weerspiegelt rechtstreeks het resultaat van de driverservice [SWS_FrIf_05039]:

• E_OK: De API-service van de FlexRay-transceiverdriver is met succes uitgevoerd en heeft E_OK geretourneerd [SWS_FrIf_05039].
• E_NOT_OK: De aanroep van de driverservice is mislukt en heeft E_NOT_OK teruggemeld [SWS_FrIf_05039].

De functie FrIf_CancelAbsoluteTimer dient voor het synchroon afbreken van een geconfigureerde absolute timer op een FlexRay Communication Controller (CC) [SWS_FrIf_05023]. Deze fungeert als wrapper rond de overeenkomstige stuurprogrammafunctie Fr_CancelAbsoluteTimer() van het FlexRay-stuurprogramma en is beschikbaar via de header FrIf.h [SWS_FrIf_05023].

Parameters en retourwaarden

Bij de aanroep worden twee ingangsparameters meegegeven [SWS_FrIf_05023]:

• FrIf_CtrlIdx: index van de aan te spreken FlexRay-controller.
• FrIf_AbsTimerIdx: Index van de af te breken absolute timer.

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

• E_OK: De onderliggende aanroep van de FlexRay-stuurprogramma-API is succesvol beëindigd met E_OK [SWS_FrIf_05023].
• E_NOT_OK: De aanroep van de stuurprogramma-API is mislukt (teruggave E_NOT_OK) of er is in de ontwikkelingsmodus (Development Mode) een fout gedetecteerd [SWS_FrIf_05023].

Gelijktijdigheid en beperkingen

De uitvoering vindt synchroon plaats met de service-ID 0x1b [SWS_FrIf_05023]. Wat betreft de re-entrancy is de service re-entrant voor verschillende FlexRay CC's, maar mag deze voor dezelfde FlexRay CC niet gelijktijdig worden aangeroepen [SWS_FrIf_05023].

De functie FrIf_DisableAbsoluteTimerIRQ maakt deel uit van de FlexRay-interfacemodule en wordt via het headerbestand FrIf.h beschikbaar gesteld [SWS_FrIf_05031]. Deze dient als synchrone wrapper voor de functie Fr_DisableAbsoluteTimerIRQ() van de FlexRay-stuurprogramma-API en stuurt het verzoek tot deactivering van het genereren van interrupts van de geadresseerde absolute timer door naar het stuurprogrammaniveau [SWS_FrIf_05031].

Aanroepcontext en parameters

De aanroep vindt synchroon plaats met gebruikmaking van de service-ID 0x23 [SWS_FrIf_05031]. De interface heeft geen in-/uitvoer- of zuivere uitvoerparameters, maar vereist twee verplichte ingangsparameters [SWS_FrIf_05031]:

• FrIf_CtrlIdx: Index van de aan te spreken FlexRay Communication Controller (CC) [SWS_FrIf_05031].
• FrIf_AbsTimerIdx: Index van de te configureren absolute timer [SWS_FrIf_05031].

Retourwaarden en foutafhandeling

De functie retourneert de status via het retourtype Std_ReturnType aan de aanroeper [SWS_FrIf_05031]:

• E_OK: Signaleert dat de aanroep van de API-service van het FlexRay-stuurprogramma succesvol was en E_OK heeft geretourneerd [SWS_FrIf_05031].
• E_NOT_OK: Geeft aan dat de API-service van het FlexRay-stuurprogramma E_NOT_OK heeft geretourneerd of dat in de ontwikkelingsmodus (Development Mode) een fout is vastgesteld [SWS_FrIf_05031].

Gelijktijdigheid en re-entrantie

Volgens de re-entrancyvoorschriften is FrIf_DisableAbsoluteTimerIRQ niet-re-entrant voor dezelfde FlexRay Communication Controller, maar wel re-entrant voor verschillende FlexRay-CC's [SWS_FrIf_05031]. Aanroepen voor dezelfde controllerinstantie mogen daarom niet gelijktijdig vanuit verschillende contexten zonder synchronisatie plaatsvinden.

De synchrone interface FrIf_AllSlots dient binnen de FlexRay-interface als wrapper voor de aanroep van de onderliggende stuurprogrammafunctie Fr_AllSlots van het FlexRay-stuurprogramma [SWS_FrIf_05020]. De functie wordt via het headerbestand FrIf.h beschikbaar gesteld en heeft service-ID 0x33 [SWS_FrIf_05020]. Als enige overdrachtsparameter wordt FrIf_CtrlIdx verwacht, die de logische index van de aan te spreken FlexRay Communication Controller definieert [SWS_FrIf_05020]. In- en uitvoerparameters (inout/out) zijn voor deze service niet voorzien [SWS_FrIf_05020].

Als retourwaarde levert de functie de status Std_ReturnType met de volgende betekenissen [SWS_FrIf_05020]:

• E_OK: De aanroep van de stuurprogramma-API Fr_AllSlots was succesvol en retourneerde E_OK [SWS_FrIf_05020].
• E_NOT_OK: De aanroep van het FlexRay-stuurprogramma is mislukt resp. heeft E_NOT_OK geretourneerd, of er werd tijdens de uitvoering in de ontwikkelingsmodus een fout gedetecteerd [SWS_FrIf_05020].

Met betrekking tot het runtimegedrag en gelijktijdigheid is FrIf_AllSlots gespecificeerd als niet-re-entrant (non reentrant) [SWS_FrIf_05020]. De aanroepende instantie moet daarom waarborgen dat gelijktijdige of overlappende aanroepen voor de desbetreffende controller uitgesloten zijn. Interpretatie: Vermoedelijk moet de aanroep vanuit een beschermde taakcontext plaatsvinden, aangezien de interface bij parallelle toegang geen eigen re-entrancybeheer biedt. Vraag Q-e4ce542c60b470c8 (open)

Gebruik

De synchrone functie FrIf_CancelTransmit verzoekt om de annulering van een lopende PDU-verzending in een onderliggende communicatiemodule [SWS_FrIf_05070]. Als invoerparameter wordt TxPduId meegegeven, die de te annuleren PDU identificeert. De uitvoering geschiedt synchroon en levert een retourwaarde op van het type Std_ReturnType [SWS_FrIf_05070]:

• E_OK: Het afbreken van de overdracht is door de doelmodule succesvol uitgevoerd.
• E_NOT_OK: De annulering is afgewezen door de doelmodule.

Gelijktijdigheid en beperkingen

Wat concurrency betreft, is FrIf_CancelTransmit reentrant voor verschillende PDU-ID's, maar niet reentrant voor dezelfde TxPduId [SWS_FrIf_05070]. Bij aanroepen vanuit parallelle contexten voor dezelfde PDU-ID is aan de zijde van de oproeper daarom vermoedelijk een externe synchronisatie vereist om race conditions te voorkomen. Vraag Q-38e799ac1564f60f (open)

Foutafhandeling en integratie

Specifieke DET- of DEM-foutcodes zijn in de interface niet gedefinieerd; het mislukken van een annulering wordt rechtstreeks gesignaleerd via de retourwaarde E_NOT_OK [SWS_FrIf_05070]. De service heeft de service-ID 0x4a en wordt beschikbaar gesteld via het headerbestand FrIf.h [SWS_FrIf_05070].

De functie FrIf_DisableLPdu dient als wrapper voor de driverfunctie Fr_DisableLPdu van de FlexRay-driver en deactiveert de onderliggende hardwareresource van een L-PDU voor verzending resp. ontvangst [SWS_FrIf_05710].

Aanroep en parameters

De aanroep van FrIf_DisableLPdu vindt synchroon plaats via de interface FrIf.h met service-ID 0x28 [SWS_FrIf_05710]. De functie verwacht twee invoerparameters:

• FrIf_CtrlIdx: Index van de FlexRay Communication Controller in de context van de FlexRay-interface [SWS_FrIf_05710].
• FrIf_LPduIdx: Unieke index ter identificatie van het betreffende FlexRay-frame [SWS_FrIf_05710].

Retourwaarden en foutafhandeling

De functie retourneert als resultaat een status van het type Std_ReturnType [SWS_FrIf_05710]:

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

Gelijktijdigheid en beperkingen

Wat betreft het concurrencygedrag is FrIf_DisableLPdu gespecificeerd als niet re-entrant voor hetzelfde apparaat (Non Reentrant for the same device) [SWS_FrIf_05710]. Parallelle aanroepen voor dezelfde controller resp. hetzelfde apparaat moeten daarom aan de aanroeperszijde worden vermeden of gesynchroniseerd.

De functie FrIf_EnableTransceiverBranch kapselt als synchrone en re-entrante wrapper de API-aanroep FrTrcv_EnableTransceiverBranch van het onderliggende FlexRay-transceiverstuurprogramma [SWS_FrIf_05085] in. Via deze interface wordt een bepaalde tak van een transceiver, bijvoorbeeld in de context van een actieve ster, gericht geactiveerd [SWS_FrIf_05085]. De functiedeclaratie en bijbehorende typen worden via het headerbestand FrIf.h beschikbaar gesteld [SWS_FrIf_05085].

Parameters en aanroepvoorwaarden

Bij de aanroep moeten drie invoerparameters worden meegegeven [SWS_FrIf_05085]:

• FrIf_CtrlIdx: Adresseert de index van de desbetreffende FlexRay Communication Controller [SWS_FrIf_05085].
• FrIf_ChnlIdx: Specificeert het FlexRay-kanaal binnen het geldigheidsbereik van de controller FrIf_CtrlIdx [SWS_FrIf_05085]. Daarbij geldt de dwingende beperking dat de enum-waarde FR_CHANNEL_AB niet mag worden gebruikt [SWS_FrIf_05085].
• FrIf_BranchIdx: Bepaalt via een op nul gebaseerde index de concrete tak van de transceiver waarop de activering wordt toegepast [SWS_FrIf_05085].

Retourwaarden

De functie levert een statuswaarde van het type Std_ReturnType terug, die direct het resultaat van de doorgestuurde stuurprogramma-aanroep weerspiegelt [SWS_FrIf_05085]:

• E_OK: De aanroep van de stuurprogrammaservice FrTrcv_EnableTransceiverBranch was succesvol en heeft E_OK teruggemeld [SWS_FrIf_05085].
• E_NOT_OK: De aanroep van de stuurprogrammaservice heeft E_NOT_OK gemeld [SWS_FrIf_05085].

De synchrone en reentrante functie FrIf_DisableTransceiverBranch kapselt als wrapper-functie de service FrTrcv_DisableTransceiverBranch van de FlexRay-transceiverdriver in [SWS_FrIf_05028]. Deze wordt beschikbaar gesteld via het headerbestand FrIf.h, heeft de service-ID 0x37 en dient ertoe een specifieke tak van een actieve ster-transceiver gericht te deactiveren [SWS_FrIf_05028].

Bij de aanroep moeten drie ingangsparameters worden meegegeven:

• FrIf_CtrlIdx: Index van de te adresseren FlexRay-controller [SWS_FrIf_05028].
• FrIf_ChnlIdx: FlexRay-kanaal binnen het geldigheidsbereik van de controller. Hierbij geldt het bindende voorschrift dat de enum-waarde FR_CHANNEL_AB niet mag worden gebruikt [SWS_FrIf_05028].
• FrIf_BranchIdx: Nulgebaseerde index die de betreffende tak van de transceiver identificeert waarop de bewerking moet worden toegepast [SWS_FrIf_05028].

Als retourwaarde levert de interface een status van het type Std_ReturnType op. Deze retourneert E_OK wanneer de aanroep van de transceiverdriver succesvol was, en E_NOT_OK indien de driverservice E_NOT_OK heeft gemeld [SWS_FrIf_05028]. Specifieke DET- of DEM-foutmeldingen zijn in de specificatie niet gedocumenteerd; een mislukking vloeit vermoedelijk direct voort uit het gedrag van de onderliggende driver. Vraag Q-52d5e5fedd147532 (open)

De synchrone functie FrIf_ReconfigLPdu dient voor de herconfiguratie van een L-PDU in de FlexRay-interface (FrIf) en geeft de aanroep direct door aan de stuurprogrammainterface Fr_ReconfigLPdu van het FlexRay-stuurprogramma [SWS_FrIf_05048]. De interface wordt via de header FrIf.h ter beschikking gesteld [SWS_FrIf_05048].

Parameters en configuratiebeperkingen

• FrIf_CtrlIdx: Adresseert de index van de FlexRay-communicatiecontroller binnen het FlexRay-stuurprogramma [SWS_FrIf_05048].
• FrIf_LPduIdx: Bepaalt de unieke index ter identificatie van het te configureren FlexRay-frame [SWS_FrIf_05048].
• FrIf_FrameId, FrIf_CycleRepetition, FrIf_CycleOffset: Definiëren de nieuwe FlexRay-frame-ID evenals herhaling en offset van het cyclusfiltermechanisme van de L-PDU [SWS_FrIf_05048].
• FrIf_ChnlIdx: Bepaalt het FlexRay-kanaal van het type Fr_ChannelType [SWS_FrIf_05048]. Hierbij is strikt voorgeschreven dat de enum-waarde FR_CHANNEL_AB niet mag worden gebruikt [SWS_FrIf_05048].
• FrIf_PayloadLength en FrIf_HeaderCRC: Leggen de lengte van de gebruikersgegevens in bytes evenals de bijbehorende header-CRC vast waarop de L-PDU moet worden ingesteld [SWS_FrIf_05048].

Retourwaarden en uitvoeringscontext

De retourwaarde van het type Std_ReturnType geeft het resultaat van de herconfiguratie aan: E_OK signaleert de succesvolle uitvoering van de API-aanroep, terwijl E_NOT_OK een voortijdige beëindiging wegens een fout aangeeft [SWS_FrIf_05048].

De functie is synchroon en gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_FrIf_05048]. Deze mag bijgevolg niet gelijktijdig worden aangeroepen.

De functie FrIf_ReadCCConfig vormt een synchrone service van de FlexRay-interface met de service-ID 0x3b en is gedeclareerd via de header FrIf.h [SWS_FrIf_05313]. Haar primaire taak bestaat erin als wrapper de stuurprogrammafunctie Fr_ReadCCConfig() van het onderliggende FlexRay-stuurprogramma aan te roepen om configuratieparameters van een controller uit te lezen [SWS_FrIf_05313].

De interface verwacht bij de aanroep drie parameters [SWS_FrIf_05313]:

• FrIf_CtrlIdx (invoer): De numerieke index van de aan te spreken FlexRay-communicatiecontroller (CC).
• FrIf_ConfigParamIdx (invoer): De index van de specifieke configuratieparameter waarvan de waarde moet worden opgevraagd.
• FrIf_ConfigParamValuePtr (uitvoer): Een pointer naar de geheugenlocatie waarop de gelezen 32-bits configuratiewaarde wordt opgeslagen.

De retourwaarde van het type Std_ReturnType signaleert het resultaat van de opvraging [SWS_FrIf_05313]:

• E_OK: De aanroep van de stuurprogramma-API Fr_ReadCCConfig() werd succesvol uitgevoerd en gaf E_OK terug.
• E_NOT_OK: Het FlexRay-stuurprogramma meldde E_NOT_OK of er werd tijdens de uitvoering in de ontwikkelingsmodus (Development Mode) een fout gedetecteerd.

Met betrekking tot gelijktijdigheid en de uitvoeringsomgeving is FrIf_ReadCCConfig niet-re-entrant voor dezelfde FlexRay-controller, maar wel re-entrant voor verschillende controllers [SWS_FrIf_05313]. Bij toegang tot dezelfde controller moet de aanroeper daarom een geschikte synchronisatie waarborgen. Een in ontwikkelingsmodus gedetecteerde fout wordt vermoedelijk doorgestuurd naar de Default Error Tracer (DET). Vraag Q-bfe56460515de4de (open)

Gebruik en semantiek

De synchrone functie FrIf_EnableBusMirroring schakelt bus-mirroring om voor alle FlexRay-controllers die zijn aangesloten op het meegegeven FlexRay-cluster [SWS_FrIf_05726]. Via de parameter FrIf_ClstIdx wordt het betreffende cluster geadresseerd. De booleaanse parameter FrIf_MirroringActive bepaalt de modus: bij doorgifte van TRUE wordt voor elk op de controllers ontvangen of verzonden frame de interface Mirror_ReportFlexRayFrame aangeroepen; bij FALSE wordt het doorsturen van de frames naar de mirror-module gedeactiveerd [SWS_FrIf_05726].

Retourwaarden en foutafhandeling

De functieaanroep levert een status van het type Std_ReturnType op [SWS_FrIf_05726]:

• E_OK: De spiegelingsmodus voor het opgegeven cluster is met succes bijgewerkt [SWS_FrIf_05726].
• E_NOT_OK: Het omschakelen is geweigerd wanneer de spiegelfunctie globaal is gedeactiveerd (configuratieparameter FrIfBusMirroringSupport) of wanneer er sprake is van een ongeldige index [SWS_FrIf_05726]. Interpretatie: De specificatievermelding FrIf_CtrlIdx bij E_NOT_OK heeft vermoedelijk, ondanks de afwijkende aanduiding, betrekking op de controle van de clusterindex FrIf_ClstIdx respectievelijk de toegewezen controllers. Vraag Q-9daba2ff2b1a3ff1 (open)

Gelijktijdigheid en integratie

De functie is gedeclareerd als reentrant en heeft service-ID 0x4b; deze wordt beschikbaar gesteld via het headerbestand FrIf.h [SWS_FrIf_05726]. Oproepers moeten er rekening mee houden dat de uitvoering synchroon geschiedt. Aanvullende foutkanalen via DET of DEM zijn voor deze service niet vermeld.

Gebruik en aanroepcontext

De functie FrIf_CheckWakeupByTransceiver (service-ID 0x39) fungeert in de FlexRay-interface als synchrone wrapper voor de functie FrTrcv_CheckWakeupByTransceiver() van het FlexRay-transceiverstuurprogramma [SWS_FrIf_05041]. Deze wordt via de header FrIf.h beschikbaar gesteld en heeft geen retourwaarde [SWS_FrIf_05041].

Voor de adressering van de desbetreffende hardware-instantie vereist de interface twee verplichte parameters [SWS_FrIf_05041]:

• FrIf_CtrlIdx (ingangsparameter, uint8): Index van de te adresseren FlexRay Communication Controller [SWS_FrIf_05041].
• FrIf_ChnlIdx (ingangsparameter, Fr_ChannelType): Index van het aan te spreken FlexRay-kanaal binnen het geldigheidsbereik van de opgegeven controller FrIf_CtrlIdx [SWS_FrIf_05041].

Gelijktijdigheid en beperkingen

De specificatie merkt de interface aan als re-entrant, zodat synchrone aanroepen gelijktijdig kunnen worden uitgevoerd [SWS_FrIf_05041].

Voor de kanaalparameter FrIf_ChnlIdx geldt een strikte gebruiksbeperking: de enum-waarde FR_CHANNEL_AB mag niet worden meegegeven [SWS_FrIf_05041]. Interpretatie: Dit betekent vermoedelijk dat het onderliggende transceiverstuurprogramma geen gecombineerde wake-upcontrole van beide kanalen in één aanroep ondersteunt en dat systemen met twee FlexRay-kanalen in plaats daarvan sequentieel of per kanaal gescheiden moeten worden gecontroleerd. Vraag Q-a30cf39f0d3ca295 (open)

De callback-functie <User_RxIndication> dient voor het signaleren van een ontvangen PDU vanuit de onderliggende communicatie-interfacelaag [SWS_FrIf_05045]. Interpretatie: De identifier vertegenwoordigt vermoedelijk een configureerbare callback van een bovenliggende laag die bij binnenkomst van FlexRay-gegevens wordt genotificeerd. Vraag Q-a9037bc7502dd9ea (open)

Gebruik en parameters

De uitvoering geschiedt synchroon zonder retourwaarde (void) [SWS_FrIf_05045]. Bij de aanroep worden twee invoerparameters meegegeven [SWS_FrIf_05045]:

• RxPduId (PduIdType): Unieke identifier van de ontvangen PDU [SWS_FrIf_05045].
• PduInfoPtr (const PduInfoType*): Pointer naar een structuur met de lengte van de ontvangen PDU (SduLength), een pointer naar de buffer met de payloadgegevens (SduDataPtr) alsmede bijbehorende metadata [SWS_FrIf_05045].

Gelijktijdigheid en configuratie

Wat reentrantie betreft, is de functie reentrant voor verschillende PDU-ID's, maar mag deze voor dezelfde PDU-ID niet reentrant worden aangeroepen [SWS_FrIf_05045]. De interface is in de module configureerbaar beschikbaar („Available via configurable”) [SWS_FrIf_05045]. Specifieke foutcodes, retourwaarden of notificaties aan DET en DEM zijn in de bronnen voor deze interface niet gedefinieerd [SWS_FrIf_05045].

De configureerbare callback-functie <User_TxConfirmation> wordt door de onderliggende communicatie-interfacemodule aangeroepen om de voltooiing van een verzendproces voor een PDU te bevestigen [SWS_FrIf_05046]. Deze meldt de bovenliggende laag synchroon of de verzending van de betreffende PDU succesvol is verlopen of is mislukt [SWS_FrIf_05046].

De interface heeft geen retourwaarde (void) en verwacht twee ingangsparameters [SWS_FrIf_05046]:

• TxPduId (type PduIdType): Duidt de unieke ID van de verzonden PDU aan [SWS_FrIf_05046].
• result (type Std_ReturnType): Geeft het resultaat van de verzending aan, waarbij E_OK de succesvolle verzending bevestigt en E_NOT_OK het mislukken van de PDU-verzending meldt [SWS_FrIf_05046].

De functie werkt synchroon [SWS_FrIf_05046]. Met betrekking tot concurrency is zij reentrant voor verschillende PDU-ID's, maar niet reentrant voor dezelfde TxPduId [SWS_FrIf_05046]. Parallelle bevestigingsaanroepen voor identieke PDU-ID's moeten daarom worden uitgesloten.

Specifieke foutcodes naast E_NOT_OK of afzonderlijke meldingen aan DET of DEM zijn voor deze aanroep niet gespecificeerd [SWS_FrIf_05046]. Interpretatie: Aangezien de interface als configureerbaar is aangemerkt, dient de identifier <User_TxConfirmation> vermoedelijk als tijdelijke aanduiding voor de functienaam die daadwerkelijk in de bovenliggende laag is geconfigureerd [SWS_FrIf_05046]. Vraag Q-f2a08258df49b3ec (open)

Gebruik

De synchrone callback-functie <User_TriggerTransmit> wordt aangeroepen om SDU-gegevens van een bovenliggende laag op te vragen voor verzending [SWS_FrIf_05047]. Als parameters worden de identifier TxPduId van de te verzenden SDU alsmede de pointer PduInfoPtr van het type PduInfoType* meegegeven [SWS_FrIf_05047]. De oproeper stelt via PduInfoPtr->SduDataPtr een doelbuffer beschikbaar en geeft in PduInfoPtr->SduLength de beschikbare buffergrootte aan [SWS_FrIf_05047].

De aangeroepen module van de bovenliggende laag controleert of de klaarliggende gegevens in de opgegeven buffergrootte passen [SWS_FrIf_05047]:

• Passen de gegevens, dan kopieert de module deze naar PduInfoPtr->SduDataPtr, actualiseert PduInfoPtr->SduLength naar het aantal daadwerkelijk gekopieerde bytes en retourneert E_OK [SWS_FrIf_05047].
• Passen de gegevens niet, dan retourneert de module E_NOT_OK zonder PduInfoPtr te wijzigen [SWS_FrIf_05047].

Foutafhandeling en gelijktijdigheid

In het geval van een fout (retourwaarde E_NOT_OK) zijn er geen SDU-gegevens gekopieerd. In dat geval mag PduInfoPtr niet verder worden gebruikt, aangezien deze een NULL-pointer kan bevatten of naar ongeldige gegevens kan verwijzen [SWS_FrIf_05047].

De interface is reentrant voor verschillende PDU-ID's, maar niet reentrant voor dezelfde PDU-ID [SWS_FrIf_05047]. De beschikbaarheid van de functie is configureerbaar [SWS_FrIf_05047].

De functie <Free_Op_A> is ontworpen als door de gebruiker gedefinieerde communicatiebewerking in het FlexRay-interface om hardwarespecifieke of aanvullende functies van de Communication Controller ter verhoging van de algehele prestaties te ondersteunen [SWS_FrIf_05316]. De declaratie van deze interface wordt beschikbaar gesteld via de header FrIf_Externals.h [SWS_FrIf_05316].

Voor de aanroep zijn twee functionele invoerparameters voorgeschreven [SWS_FrIf_05316]:

• FrIf_CtrlIdx (type uint8): Duidt als index de concreet aan te spreken FlexRay Communication Controller aan [SWS_FrIf_05316].
• FrIf_LPduIdx (type uint16): Dient als unieke index voor de identificatie van het betreffende FlexRay-frame [SWS_FrIf_05316].

De bewerking wordt synchroon uitgevoerd en heeft geen retourwaarde (void); invoer- en uitvoerparameters zijn evenmin voorzien [SWS_FrIf_05316]. Wat betreft concurrency en aanroepcontext is de functie reentrant voor verschillende waarden van FrIf_LPduIdx, maar expliciet niet reentrant bij gebruik van dezelfde index FrIf_LPduIdx [SWS_FrIf_05316].

Specifieke foutcodes en mechanismen voor foutbewaking via de Default Error Tracer (DET) of de Diagnostic Event Manager (DEM) module zijn in de specificatie niet vermeld [SWS_FrIf_05316]. Oproepende componenten moeten daarom voorafgaand aan de uitvoering waarborgen dat er geen gelijktijdige toegangen tot dezelfde frame-index plaatsvinden [SWS_FrIf_05316].

De door de gebruiker gedefinieerde functie <Free_Op_B> dient voor het uitvoeren van gebruikersspecifieke communicatiebewerkingen in de FlexRay-interface [SWS_FrIf_05317]. Het doel ervan is om hardwarespecifieke of aanvullende prestatiekenmerken van de FlexRay-communication-controller te ondersteunen om de communicatieprestaties te verbeteren [SWS_FrIf_05317]. De functiedeclaratie wordt via het headerbestand FrIf_Externals.h beschikbaar gesteld [SWS_FrIf_05317].

Aanroep en parameters

De bewerking wordt synchroon aangeroepen en levert geen retourwaarde op (void) [SWS_FrIf_05317]. Deze verwerkt twee ingangsparameters, terwijl er noch in-/uitgangs- noch uitgangsparameters bestaan [SWS_FrIf_05317]:

• FrIf_CtrlIdx: Index van de aan te spreken FlexRay-communication-controller (type uint8) [SWS_FrIf_05317].
• FrIf_LPduIdx: Unieke index ter aanduiding van het betreffende FlexRay-frame (type uint16) [SWS_FrIf_05317].

Gelijktijdigheid en beperkingen

Wat re-entrantie betreft is de functie voor verschillende LPdu-indices (FrIf_LPduIdx) re-entrant, maar voor dezelfde LPdu-index expliciet als niet-re-entrant gespecificeerd [SWS_FrIf_05317]. Oproepers moeten er daarom voor zorgen dat gelijktijdige aanroepen voor dezelfde PDU achterwege blijven.

Interpretatie: Aangezien de bewerking als gebruikersgedefinieerd is aangemerkt en in FrIf_Externals.h is opgenomen, zal de daadwerkelijke implementatie vermoedelijk gebruikersspecifiek resp. als driveruitbreiding moeten worden geleverd. Vraag Q-6668832db63b9906 (open)

Gebruik

De notificatiefunctie <UL_ Tx Conflict Notification> wordt aangeroepen zodra er in het FlexRay-interface een overdrachtsconflict (Tx Conflict) is vastgesteld [SWS_FrIf_91001]. De declaratie van deze interface wordt beschikbaar gesteld via het headerbestand Fr If_ Externals.h [SWS_FrIf_91001].

De functie heeft geen retourwaarde en accepteert twee invoerparameters [SWS_FrIf_91001]:

• Fr If_ Ctrl Idx: Identifier van de geadresseerde FlexRay Communication Controller [SWS_FrIf_91001].
• Fr If_ LPdu Idx: Identifier van het betreffende verzonden FlexRay-frame [SWS_FrIf_91001].

Gelijktijdigheid en beperkingen

De aanroep vindt plaats met synchrone semantiek [SWS_FrIf_91001]. Wat betreft concurrency is de uitvoering re-entrant voor verschillende indices van Fr If_ LPdu Idx, maar expliciet niet-re-entrant voor dezelfde LPdu-index [SWS_FrIf_91001]. Bij de implementatie moet er daarom voor worden gezorgd dat gelijktijdige aanroepen voor dezelfde frame-index worden voorkomen.

Foutafhandeling en wisselwerking

De specificatie definieert voor deze callback-interface geen afzonderlijke DET- of DEM-meldingen en geen specifieke foutcodes [SWS_FrIf_91001]. Interpretatie: de bovenliggende laag stelt de aanroep vermoedelijk beschikbaar om direct opgetreden conflicten op het FlexRay-overdrachtstraject te kunnen loggen of afhandelen. Vraag Q-fc63c251dbc03307 (open)

Gebruik en waardebereik

Het enumeratietype FrIf_StateType wordt gedefinieerd in het headerbestand FrIf.h en dient er in het FlexRay Interface voor om de actuele bedrijfstoestand van een FlexRay Communication Controller (FlexRay CC) weer te geven [SWS_FrIf_05755]. Variabelen van dit type leggen vast of een controller gereed is voor communicatiebedrijf en of er sprake is van synchronisatie met het FlexRay-cluster [SWS_FrIf_05755].

Het waardebereik omvat twee gedefinieerde toestanden [SWS_FrIf_05755]:

• FRIF_STATE_OFFLINE: De FlexRay CC is niet gereed voor communicatie en het FlexRay-cluster is niet gesynchroniseerd [SWS_FrIf_05755].
• FRIF_STATE_ONLINE: De FlexRay CC is gereed voor communicatie en het FlexRay-cluster is gesynchroniseerd [SWS_FrIf_05755].

Integratie en randvoorwaarden

De toestanden weerspiegelen fundamentele communicatiefasen: zolang FRIF_STATE_OFFLINE actief is, kan er geen reguliere clustercommunicatie via de controller plaatsvinden, terwijl FRIF_STATE_ONLINE het gesynchroniseerde zend- en ontvangstbedrijf kenmerkt [SWS_FrIf_05755]. Aangezien het specificatie-uittreksel geen verdere API-signaturen of foutmeldingen noemt, zal het type vermoedelijk primair worden gebruikt in statusopvragingen of toestandsovergangen van het FlexRay Interface. Vraag Q-071cd300dcaa0a3b (open)

Het enumeratietype FrIf_StateTransitionType wordt beschikbaar gesteld via het headerbestand FrIf.h en dient conform [SWS_FrIf_05303] voor de representatie respectievelijk het verzoeken van toestandsovergangen voor een FlexRay Communication Controller (FlexRay CC).

Gebruik en waardebereik

Variabelen van dit type nemen waarden aan om gerichte toestandsveranderingen van een FlexRay CC aan te vragen [SWS_FrIf_05303]. Het waardebereik omvat de volgende literals:

• FRIF_GOTO_OFFLINE: Literal voor het aanvragen van een overgang naar de toestand FRIF_STATE_OFFLINE [SWS_FrIf_05303].
• FRIF_GOTO_ONLINE: Literal voor het aanvragen van een overgang naar de toestand FRIF_STATE_ONLINE [SWS_FrIf_05303].

Context en interactie

Hoewel de formele beschrijving van het type spreekt over de representatie van de toestand van een FlexRay CC, wekken de gedefinieerde literals de suggestie dat dit opsommingstype primair dient als stuurparameter voor het initiëren van toestandsveranderingen (offline of online) [SWS_FrIf_05303]. Omdat de payload geen verdere interfaces, reentrantievoorschriften of foutcodes voor dit type bevat, gelden de algemene integratieregels via het headerbestand FrIf.h.