LIN Interface (LinIf)

De synchrone functie LinIf_Init dient voor de initialisatie van de LIN-interface volgens [SWS_LinIf_00198]. De interface heeft de service-ID 0x01, is beschikbaar via het headerbestand LinIf.h en wordt synchroon uitgevoerd.

Aanroepcontext en parameters

De functie verwacht als enige parameter ConfigPtr (const LinIf_ConfigType*), die dient als pointer naar de configuratie van de LIN-interface [SWS_LinIf_00198]. Deze heeft geen retourwaarde en beschikt niet over in-/uitgangs- of zuivere uitgangsparameters.

Initialisatieprocessen en interactie

In het kader van de initialisatie voert de LIN-interface specifieke instellingen uit voor slave-knooppunten:

• Volgens [SWS_LinIf_00767] initialiseert de module in LinIf_Init het initiële knooppuntadres (initial NAD) en het geconfigureerde knooppuntadres (configured NAD) van het slave-knooppunt aan de hand van de configuratieparameters LinIfInitialNAD en LinIfConfiguredNAD.
• Volgens [SWS_LinIf_00768] initialiseert de module in LinIf_Init de geconfigureerde PID's van het slave-knooppunt uit de configuratiegegevens via de configuratieparameters LinIfFrameId.

Gelijktijdigheid en beperkingen

De functie is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_LinIf_00198]. Een gelijktijdige of overlappende aanroep is daarom niet toegestaan. Specifieke foutcodes of DET-meldingen zijn in de verstrekte specificatieomvang voor deze service niet vermeld.

Gebruik en aanroepcontext

De in LinIf.h gedeclareerde functie LinIf_Transmit (service-ID 0x49) dient voor het synchrone verzoek tot overdracht van een PDU [SWS_LinIf_00201]. Als invoerparameter verwacht deze TxPduId voor de eenduidige identificatie van de te verzenden PDU, alsmede de pointer PduInfoPtr naar een PduInfoType-structuur, die naast de datalengte en de feitelijke payload ook metagegevens kan refereren [SWS_LinIf_00201]. Aanvullende in-/uitvoer- of uitvoerparameters bestaan niet [SWS_LinIf_00201].

Retourwaarden en gedragsvereisten

Als retourwaarde levert de service de status Std_ReturnType [SWS_LinIf_00201]:

• E_OK: het overdrachtsverzoek is succesvol geaccepteerd door het LIN-interface [SWS_LinIf_00201].
• E_NOT_OK: het verzoek tot overdracht kon niet worden geaccepteerd [SWS_LinIf_00201].

De interactie met de frametypes wordt door [SWS_LinIf_00700] gepreciseerd: bij een geïnitialiseerd LIN-interface retourneert LinIf_Transmit ook dan E_OK wanneer de PDU tot een niet-sporadisch frame op een LIN-masterknooppunt of tot een niet-gebeurtenisgestuurd frame op een LIN-slaveknooppunt behoort.

Concurrency

Met betrekking tot de uitvoeringsomgeving is LinIf_Transmit re-entrant voor verschillende PDU-ID's, maar mag voor dezelfde TxPduId niet gelijktijdig resp. concurrent worden aangeroepen [SWS_LinIf_00201].

De functie LinIf_ScheduleRequest dient uitsluitend op LIN-master-knooppunten om de uitvoering van een vooraf bepaalde schedule-tabel aan te vragen [SWS_LinIf_00202]. De aanroep wordt asynchroon verwerkt en is ontworpen als re-entrant [SWS_LinIf_00202].

Parameters en retourwaarden

Via de parameter Channel wordt de betreffende LIN-kanaalindex doorgegeven, terwijl Schedule de identificatie van de nieuw uit te voeren schedule-tabel vastlegt [SWS_LinIf_00202]. De functie retourneert de status als Std_ReturnType:

• E_OK: De wisselopdracht voor de schedule-tabel is succesvol geaccepteerd [SWS_LinIf_00202].
• E_NOT_OK: De omschakeling is geweigerd [SWS_LinIf_00202].

Foutvoorwaarden en beperkingen

Een retourwaarde van E_NOT_OK treedt volgens de specificatie op in de volgende foutgevallen [SWS_LinIf_00202]:

• De LIN-interface is nog niet geïnitialiseerd.
• Het gereferentieerde kanaal bestaat niet of de doorgegeven index ligt buiten het waardebereik.
• De gereferentieerde schedule-tabel bestaat niet of de identificatie ervan is ongeldig.
• De huidige toestand is Sleep.

Samenspel

Het mislukken van een schedule-aanvraag heeft gevolgen voor bovenliggende transportprocessen: Als in het kader van een LinTp_Transmit-aanroep via BswM_LinTp_RequestMode een schedule-wissel via LinIf_ScheduleRequest wordt geïnitieerd, moet LinTp_Transmit dwingend E_NOT_OK retourneren wanneer LinIf_ScheduleRequest met E_NOT_OK antwoordt [SWS_LinIf_00878].

Gebruik

De functie LinIf_GotoSleep (service-ID 0x06, gedeclareerd in LinIf.h) initialiseert de overgang naar de slaapmodus op het gespecificeerde LIN-kanaal [SWS_LinIf_00204]. De aanroep geschiedt asynchroon en neemt als invoerparameter Channel van het type NetworkHandleType de identificatie van het betreffende kanaal over [SWS_LinIf_00204].

Retourwaarden en foutafhandeling

Als retourwaarde levert de service het type Std_ReturnType met de volgende betekenissen [SWS_LinIf_00204]:

• E_OK: het verzoek om over te schakelen naar de slaapmodus is succesvol geaccepteerd, de toestandsovergang naar de slaapmodus loopt reeds of de controller bevindt zich reeds in de slaaptoestand [SWS_LinIf_00204].
• E_NOT_OK: het verzoek is niet geaccepteerd. Mogelijke oorzaken hiervoor zijn een nog niet geïnitialiseerd LIN-interface of een niet-bestaande resp. buiten het geldige waardebereik liggende kanaalidentificator [SWS_LinIf_00204].

Concurrentie en systeeminteractie

De interface is gedefinieerd als niet-re-entrant (Non Reentrant) [SWS_LinIf_00204]. Wordt LinIf_GotoSleep aangeroepen, dan moet het LIN-interface onmiddellijk de functie Lin_GotoSleepInternal aanroepen en mag niet wachten tot de volgende cyclus van de hoofdfunctie [SWS_LinIf_00757].

De re-entrante functie LinIf_Wakeup start het asynchrone ontwaakproces voor het door de parameter Channel geïdentificeerde LIN-kanaal [SWS_LinIf_00205]. Deze is beschikbaar via de header LinIf.h [SWS_LinIf_00205].

De retourwaarde Std_ReturnType geeft uitsluitsel over de acceptatie van het verzoek [SWS_LinIf_00205]:

• E_OK signaleert dat het ontwaakverzoek is geaccepteerd of dat de controller zich reeds niet meer in de slaaptoestand bevindt [SWS_LinIf_00205].
• E_NOT_OK wordt geretourneerd wanneer het LIN Interface niet is geïnitialiseerd, de doorgegeven kanaal-ID buiten het geldige bereik ligt of de onderliggende driveraanroepen Lin_Wakeup resp. Lin_WakeupInternal mislukken met E_NOT_OK [SWS_LinIf_00205].

De interactie met de gebruiker vindt plaats via de terugmeldfunctie <User>_WakeupConfirmation:

• In geval van een fout roept het LIN Interface vóór het retourneren van E_NOT_OK dwingend <User>_WakeupConfirmation(FALSE) aan [SWS_LinIf_00762].
• Bij succesvolle acceptatie (E_OK) bevestigt het LIN Interface het ontwaken asynchroon: pas wanneer daarna voor de eerste keer de functie LinIf_HeaderIndication wordt aangeroepen, voert de module de aanroep <User>_WakeupConfirmation(TRUE) uit [SWS_LinIf_00761].

De synchrone en re-entrante functie LinIf_SetTrcvMode (service-ID 0x08) dient voor het omschakelen van de opgegeven LIN-transceiver naar de verzochte bedrijfsmodus [SWS_LinIf_00544]. De interface is beschikbaar via het headerbestand LinIf.h [SWS_LinIf_00544].

Parameters en retourwaarden

De aanroep vereist twee invoerparameters [SWS_LinIf_00544]:

• Channel (NetworkHandleType): identificeert het aan te sturen LIN-kanaal [SWS_LinIf_00544].
• TransceiverMode (LinTrcv_TrcvModeType): bepaalt de aangevraagde toestandsovergang van de transceiver [SWS_LinIf_00544].

De retourwaarde van het type Std_ReturnType signaleert het resultaat van het omschakelingsproces [SWS_LinIf_00544]:

• E_OK: wordt geretourneerd wanneer de transceivertoestand succesvol naar de aangevraagde modus is gewisseld [SWS_LinIf_00544].
• E_NOT_OK: signaleert dat de toestandsverandering is mislukt of dat ten minste één parameter buiten het toelaatbare bereik ligt. De vorige toestand van de transceiver blijft ongewijzigd [SWS_LinIf_00544].

Uitvoering en foutgedrag

De functie wordt synchroon uitgevoerd en is als re-entrant gespecificeerd [SWS_LinIf_00544]. Specifieke DET- of DEM-foutmeldingen zijn in het specificatie-element niet afzonderlijk vermeld; een mislukking van de moduswijziging of ontoelaatbare parameterwaarden leiden direct tot de retourwaarde E_NOT_OK [SWS_LinIf_00544].

De synchrone en re-entrante functie LinIf_SetTrcvWakeupMode dient om notificaties voor wakeup-events op het opgegeven LIN-kanaal te activeren, te deactiveren of te resetten [SWS_LinIf_00550]. De declaratie wordt via de header LinIf.h ter beschikking gesteld en heeft de service-ID 0x0b [SWS_LinIf_00550].

De interface verwacht twee ingangsparameters [SWS_LinIf_00550]:

• Channel: Unieke identificatie van het aan te spreken LIN-netwerk resp. -kanaal van het type NetworkHandleType [SWS_LinIf_00550].
• LinTrcvWakeupMode: Aangevraagde wakeup-modus van de transceiver van het type LinTrcv_TrcvWakeupModeType [SWS_LinIf_00550].

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

• E_OK: De aanroep van de API-service van de LIN-transceiverdriver was succesvol en retourneerde E_OK [SWS_LinIf_00550].
• E_NOT_OK: De API-service van de LIN-transceiverdriver is mislukt (retourwaarde E_NOT_OK) of ten minste een van de meegegeven parameters voor kanaal of modus is ongeldig [SWS_LinIf_00550].

Wat betreft de wisselwerking delegeert de functie het verzoek naar de LIN-transceiverdriver; vermoedelijk vormt het LinIf hierbij een bemiddelende interface tussen hogere lagen en de transceiver-hardware [SWS_LinIf_00550]. Vraag Q-07b525a14a2c5fcd (open) Aangezien de service als re-entrant is gespecificeerd, mag deze parallel voor verschillende of hetzelfde kanaal worden uitgevoerd [SWS_LinIf_00550].

Gebruik en aanroepcontext

De functie LinTp_Init dient voor de initialisatie van de transportlaag van het LIN-protocol ([SWS_LinIf_00350]). Volgens specificatie [SWS_LinIf_00350] werkt de functieaanroep synchroon.

De functiesignatuur luidt void LinTp_Init (const LinTp_ConfigType* ConfigPtr). Via de invoerparameter wordt de configuratie doorgegeven:

• ConfigPtr (in): Pointer naar de configuratiegegevens van de LIN-transportlaag van het type LinTp_ConfigType ([SWS_LinIf_00350]).

De functie levert geen retourwaarde (void) en definieert noch uitgangs-, noch in-/uitgangsparameters ([SWS_LinIf_00350]). Deze heeft de hexadecimale service-ID 0x40 en wordt via het headerbestand LinIf.h ter beschikking gesteld ([SWS_LinIf_00350]).

Foutafhandeling

De requirement [SWS_LinIf_00350] definieert voor deze functie geen specifieke foutcodes, DET-meldingen of DEM-gebeurtenissen. Er vindt geen teruggave van een foutstatus aan de aanroeper plaats ([SWS_LinIf_00350]).

Gelijktijdigheid en beperkingen

De functie LinTp_Init is expliciet geclassificeerd als niet-re-entrant (Non Reentrant) ([SWS_LinIf_00350]). Deze mag bijgevolg niet gelijktijdig vanuit meerdere threads, taken of interruptroutines worden aangeroepen. Interpretatie: De aanroep zal typisch centraal plaatsvinden in het kader van de initialisatiesequentie van de basissoftware, voordat navolgende communicatieverzoeken kunnen worden verwerkt. Vraag Q-6e391bdf8abb1a09 (open)

Samenspel

Voor LinTp_Init zijn in het onderhavige uittreksel geen directe koppelingen naar verdere specificatie-requirements of naburige functies vermeld ([SWS_LinIf_00350]). De module LinIf stelt de declaratie ter beschikking ([SWS_LinIf_00350]).

De synchrone functie LinTp_Transmit dient voor het verzoeken om een PDU-overdracht via het LIN-transportprotocol ([SWS_LinIf_00351]). Als overdrachtsparameter verwacht deze de PDU-identificator TxPduId alsmede de pointer PduInfoPtr, die de datalengte en pointers naar de PDU-data en metagegevens beschikbaar stelt ([SWS_LinIf_00351]). De retourwaarde is E_OK bij succesvolle acceptatie van het verzendverzoek en E_NOT_OK in het geval van een weigering ([SWS_LinIf_00351]).

Het runtimegedrag en de interactie met het LIN Interface zijn onderworpen aan de volgende voorschriften:

• Schedule-verzoek: als de in het kader van de aanroep via BswM_LinTp_RequestMode geïnitieerde schedule-wissel bij LinIf_ScheduleRequest mislukt en E_NOT_OK oplevert, moet ook LinTp_Transmit direct met E_NOT_OK antwoorden ([SWS_LinIf_00878]).
• Bevestiging: alleen wanneer LinTp_Transmit succesvol was (retourwaarde E_OK), roept het LIN Interface na een succesvolle of mislukte schedule-tabelwissel de functie PduR_LinTpTxConfirmation met een positief of negatief resultaat aan ([SWS_LinIf_00702]). Bij een afgewezen verzendopdracht blijft deze aanroep volledig achterwege ([SWS_LinIf_00702]).
• Onderbreking van lopende processen: als tijdens het wachten op een fysiek antwoord of tijdens de antwoordontvangst een nieuw fysiek verzoek via LinTp_Transmit wordt geactiveerd, breekt het LIN Interface de lopende TP-afhandeling inclusief ontvangst en N_Cr- en P2-time-outbewaking af en accepteert het nieuwe verzoek ([SWS_LinIf_00708]).

Wat betreft concurrentie is LinTp_Transmit re-entrant voor verschillende TxPduId, maar mag voor dezelfde TxPduId niet concurrent worden uitgevoerd ([SWS_LinIf_00351]).

De functie LinTp_Shutdown dient voor het gecontroleerd afsluiten van het LIN-transportprotocol ([SWS_LinIf_00355]). Via de aanroep ervan wordt de werking van de LIN-TP-component beëindigd ([SWS_LinIf_00355]). De functiedeclaratie is beschikbaar via het headerbestand LinIf.h ([SWS_LinIf_00355]).

Voor het gebruik en de uitvoering gelden de volgende specificatiekenmerken ([SWS_LinIf_00355]):

• Parameters en retourwaarde: De functie heeft geen invoer-, in-/uitvoer- of uitvoerparameters (void) en levert geen retourwaarde (void) terug ([SWS_LinIf_00355]).
• Service-identificatie: De service is gedefinieerd onder de service-ID 0x43 ([SWS_LinIf_00355]).
• Synchroniciteit: De aanroep wordt synchroon afgehandeld ([SWS_LinIf_00355]).
• Re-entrantie: De functie is niet-re-entrant (Non Reentrant) ([SWS_LinIf_00355]). Gelijktijdige of geneste aanroepen vanuit verschillende contexten zijn niet toegestaan.

Specifieke foutcodes, terugmeldingen aan de Development Error Tracer (DET) of speciale behandelingen bij fouten zijn voor deze functie in de bronnen niet beschreven ([SWS_LinIf_00355]). Eveneens ontbreken gegevens over verwante requirements of de exacte aanroeper; vermoedelijk vindt de aanroep plaats in het kader van de sequentiële de-initialisatie van de communicatiestack door een overkoepelend BSW-toestandsbeheer. Vraag Q-e25a3c9531527c4f (open)

Gebruik en semantiek

De synchrone functie LinTp_ChangeParameter dient ertoe om een specifieke parameter van het transportprotocol voor een bepaalde PDU tijdens runtime aan te passen [SWS_LinIf_00501]. Als parameters worden de PDU-identificatie (id), de identificator van de te wijzigen transportprotocolparameter (parameter, bijvoorbeeld de blokgrootte) en de nieuwe doelwaarde (value) doorgegeven [SWS_LinIf_00501]. De declaratie wordt via de header LinIf.h ter beschikking gesteld [SWS_LinIf_00501].

Retourwaarden en gedrag bij fouten

De functie signaleert het resultaat van het verzoek direct via haar retourwaarde van het type Std_ReturnType [SWS_LinIf_00501]:

• E_OK: De aangevraagde parameter is succesvol omgezet naar de nieuwe waarde [SWS_LinIf_00501].
• E_NOT_OK: De wijziging is afgewezen door het LIN-transportprotocol [SWS_LinIf_00501]. Dit zal typisch optreden wanneer de parameter ongeldig is of een lopende overdracht de modificatie verhindert. Vraag Q-84aaf28c12dee2e9 (open)

Gelijktijdigheid en beperkingen

Volgens de specificatie is LinTp_ChangeParameter geclassificeerd als niet-re-entrant (Non Reentrant) [SWS_LinIf_00501]. Een gelijktijdige of geneste aanroep voor dezelfde of parallelle contexten is daarom niet toegestaan en moet door de aanroeper worden voorkomen. Het synchrone verloop blokkeert de aanroeper tot aan de beslissing over de overname van de parameterwaarde [SWS_LinIf_00501].

Gebruik en aanroepcontext

De synchrone functie LinIf_CheckWakeup wordt aangeroepen zodra de module EcuM op de hoogte is gesteld van een wakeup-event op een bepaald LIN-kanaal [SWS_LinIf_00378]. De aanroep vindt plaats met de invoerparameter WakeupSource van het type EcuM_WakeupSourceType [SWS_LinIf_00378]. Deze parameter specificeert het bronapparaat dat de wakeup-gebeurtenis heeft geïnitieerd, waarbij het om een LIN-controller of een LIN-transceiver kan gaan [SWS_LinIf_00378].

Foutafhandeling en retourwaarden

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

• E_OK: Tijdens de uitvoering van de interface is geen fout opgetreden [SWS_LinIf_00378].
• E_NOT_OK: Bij de uitvoering van de interface is een fout opgetreden of er is een ongeldige waarde voor WakeupSource doorgegeven [SWS_LinIf_00378].

Gelijktijdigheid en integratie

De interface is gespecificeerd als re-entrant, heeft de service-ID 0x60 en wordt beschikbaar gesteld via het headerbestand LinIf.h [SWS_LinIf_00378]. Deze verbindt de wakeup-verwerking van de EcuM direct met de kanalen van de LIN-interface [SWS_LinIf_00378].

De synchrone en re-entrante functie LinIf_EnableBusMirroring activeert of deactiveert de bus-mirroring voor een afzonderlijk LIN-kanaal [SWS_LinIf_00876]. Deze is beschikbaar via de header LinIf.h en kan vervallen als de bus-mirroring via de configuratieparameter LinIfBusMirroringSupport niet is geactiveerd [SWS_LinIf_00875]. Als aanroeper fungeert typisch de Mirror-module. Vraag Q-1703af5207cb7ade (open)

Via de parameter Channel wordt het betreffende LIN-kanaal doorgegeven, terwijl MirroringActive de modus bestuurt [SWS_LinIf_00876]: bij doorgifte van TRUE wordt de mirroring geactiveerd, bij FALSE gedeactiveerd [SWS_LinIf_00876]. Als retourwaarde levert de functie E_OK op wanneer de mirroring-modus succesvol is gewijzigd, of E_NOT_OK indien een ongeldig kanaal is opgegeven of de mirroring globaal is gedeactiveerd [SWS_LinIf_00876]. Specifieke DET- of DEM-foutmeldingen zijn in de functiedefinitie niet vermeld [SWS_LinIf_00876].

Als de bus-mirroring globaal via LinIfBusMirroringSupported alsook voor het betreffende kanaal is geactiveerd, stuurt de LIN-interface relevante gebeurtenissen door naar Mirror_ReportLinFrame:

• Ontvangen frames bij LinIf_RxIndication met status LIN_RX_OK en pointer naar de payload [SWS_LinIf_00838] alsmede bij het uitlezen van de LIN-driverstatus voor Rx-slots [SWS_LinIf_00873].
• Verzonden frames bij LinIf_TxConfirmation met status LIN_TX_OK en pointer naar de overgedragen gegevens [SWS_LinIf_00839] alsmede bij het uitlezen van de LIN-driverstatus voor Tx-slots [SWS_LinIf_00874].
• Foutnotificaties bij LinIf_LinErrorIndication voor alle foutcodes behalve LIN_ERR_HEADER met foutstatus en NULL-pointer als gegevensinhoud [SWS_LinIf_00869].

De functie LinIf_WakeupConfirmation dient ertoe de succesvolle detectie van een wakeup-event aan de LIN-interface te melden [SWS_LinIf_00715].

Aanroep en parameters

De aanroep geschiedt door de LIN-driver (LIN Driver) of de LIN-transceiverdriver (LIN Transceiver Driver), nadat een succesvolle wakeup-detectie tijdens Check Wakeup of na een inschakeling via de bus (power on by bus) heeft plaatsgevonden [SWS_LinIf_00715]. Als doorgifteparameter wordt WakeupSource van het type EcuM_WakeupSourceType meegegeven, die het bronapparaat aangeeft dat het wakeup-event heeft geïnitieerd (LIN-controller of LIN-transceiver) [SWS_LinIf_00715].

Uitvoeringseigenschappen en interface

• Semantiek: De aanroep wordt synchroon afgehandeld [SWS_LinIf_00715].
• Re-entrantie: De functie is gespecificeerd als re-entrant [SWS_LinIf_00715].
• Retourwaarde: Er is geen retourwaarde (void) [SWS_LinIf_00715].
• Header: De declaratie wordt via LinIf.h ter beschikking gesteld (service-ID: 0x61) [SWS_LinIf_00715].

De callbackfunctie LinIf_HeaderIndication wordt synchroon door de LIN-driver aangeroepen om de ontvangst van een LIN-header op een slavekanaal te melden [SWS_LinIf_91004]. Deze is uitsluitend beschikbaar wanneer de regeleenheid over ten minste één geconfigureerd LIN-slavekanaal beschikt [SWS_LinIf_91004]. De functie is re-entrant voor verschillende kanalen, maar mag voor hetzelfde kanaal niet concurrent worden aangeroepen [SWS_LinIf_91004].

Via de inout-parameter PduPtr draagt de driver de ontvangen identifier (PID) alsmede de pointer naar de SDU-databuffer over [SWS_LinIf_91004]. De LinIf evalueert de PID en stuurt de reactie van het slaveknooppunt aan:

• Ontvangstframe: behoort de PID tot een geconfigureerd ontvangstframe, dan stelt de LinIf vóór de terugkeer het controlesomtype PduPtr->Cs en de datalengte PduPtr->Dl in en wijst aan PduPtr->Drc de waarde LIN_FRAMERESPONSE_RX toe [SWS_LinIf_00733].
• Zendframes: Gaat het om een zendframe, dan vraagt de LinIf de payload op via <User_TriggerTransmit> [SWS_LinIf_00738]. Bij een succesvolle beschikbaarstelling (retourwaarde E_OK of SRF-data door Node Configuration Handler / transportprotocol) worden controlesom en lengte geconfigureerd en wordt PduPtr->Drc op LIN_FRAMERESPONSE_TX ingesteld [SWS_LinIf_00739]. Mislukt de opvraag met E_NOT_OK, dan wordt PduPtr->Drc op LIN_FRAMERESPONSE_IGNORE ingesteld [SWS_LinIf_00740].
• Irrelevante frames: Is het frame niet relevant voor de slave, dan stelt de LinIf PduPtr->Drc eveneens in op LIN_FRAMERESPONSE_IGNORE [SWS_LinIf_00748].

Daarnaast herlaadt elke aanroep de lopende bus-idle-timer [SWS_LinIf_00754]. Vindt de aanroep voor het eerst plaats na een succesvolle LinIf_Wakeup, dan wordt <User>_WakeupConfirmation(TRUE) geactiveerd [SWS_LinIf_00761]. Bij ontvangst van een SRF-header start de LinIf bovendien de N_As-timer voor Consecutive Frames (CF) [SWS_LinIf_00800]. Als retourwaarde signaleert E_OK de acceptatie van het verzoek, terwijl E_NOT_OK ontwikkelings- of productiefouten aangeeft [SWS_LinIf_91004].

De callback-functie LinIf_RxIndication wordt synchroon aangeroepen door de LIN-driver om de succesvolle ontvangst van een response inclusief de ontvangstdata aan de LIN-interface te melden [SWS_LinIf_91005]. De functie is uitsluitend beschikbaar op regeleenheden met ten minste één geconfigureerd LIN-slavekanaal [SWS_LinIf_91005].

Met betrekking tot parametrering en concurrency gelden de volgende voorwaarden:

• Parameters: Meegegeven worden de kanaalidentificatie Channel en de pointer Lin_SduPtr naar een shadow-buffer of de via memory-mapping toegankelijke ontvangstbuffer van de LIN-hardware [SWS_LinIf_91005]. Deze pointer is alleen geldig bij een daadwerkelijk ontvangen response [SWS_LinIf_91005].
• Retourwaarde: De functie heeft geen retourwaarde (void) [SWS_LinIf_91005].
• Re-entrantie: De interface is re-entrant voor verschillende LIN-kanalen, maar niet re-entrant voor hetzelfde kanaal [SWS_LinIf_91005].

In samenspel met het modulegedrag initieert de aanroep meerdere coördinerende acties:

• Doorsturen van de ontvangen payload en de payloadlengte naar de bovenliggende laag via <User_RxIndication> [SWS_LinIf_00734].
• Controle op sleep-commando's: Gaat het om een Master Request Frame (MRF) met NAD 0, dan herkent de LIN-interface een Go-to-Sleep-commando en leidt de overgang naar de sleep-modus in [SWS_LinIf_00750].
• Timer-besturing: Bij elke aanroep wordt de bus-idle-timer herladen [SWS_LinIf_00754]. Daarnaast bestuurt de aanroep bij MRF-frames (FF, CF) de N_Cr-timer (start/herstart bij FF en CF vóór het laatste frame, stop bij het laatste CF) [SWS_LinIf_00805].
• Bus-mirroring: Als mirroring globaal en voor het kanaal geactiveerd is, meldt de LIN-interface het frame met status LIN_RX_OK door via Mirror_ReportLinFrame() [SWS_LinIf_00838].

De synchrone callback-functie LinIf_TxConfirmation (service-ID 0x7a, gedeclareerd in LinIf.h) wordt door de LIN-driver aangeroepen om de succesvolle overdracht van een antwoord (respons) op het opgegeven kanaal te bevestigen [SWS_LinIf_91006]. De functie heeft geen retourwaarde en is uitsluitend bedoeld voor regeleenheden met ten minste één geconfigureerd LIN-slavekanaal [SWS_LinIf_91006].

Bij binnenkomst van de bevestiging voert de LIN-interface verschillende vervolgverwerkingen uit:

• Bovenlaag-notificatie: De module stuurt de verzendgebeurtenis via de callback-functie <User_TxConfirmation> met de retourwaarde E_OK door naar de bovenliggende laag [SWS_LinIf_00741].
• Foutstatus: Indien het succesvol verzonden frame het foutsignaal response_error bevat, reset de LIN-interface dit signaal [SWS_LinIf_00747].
• Busrustbewaking: Elke aanroep van LinIf_TxConfirmation herlaadt de lopende bus-idle-timer van het kanaal [SWS_LinIf_00754].
• Transportprotocol (LinTp): Bevestigt de driver de respons op een SRF-header (Slave Response Frame), dan stopt de interface de bewakingstimer N_As [SWS_LinIf_00800].
• Bus-mirroring: Als het spiegelen globaal via LinIfBusMirroringSupported geconfigureerd en via LinIf_EnableBusMirroring() geactiveerd is, meldt de interface het frame met status LIN_TX_OK en een pointer naar de verzenddata aan Mirror_ReportLinFrame() [SWS_LinIf_00839].

Wat betreft de concurrency is LinIf_TxConfirmation re-entrant ontworpen voor verschillende LIN-kanalen, maar mag voor hetzelfde kanaal niet re-entrant worden aangeroepen [SWS_LinIf_91006].

Gebruik en aanroepcontext

De synchrone functie LinIf_LinErrorIndication wordt door de LIN-driver aangeroepen om opgetreden fouten tijdens de verwerking van header of respons te melden [SWS_LinIf_91007]. Deze is uitsluitend bedoeld voor LIN-slave-nodes en vereist dat de regeleenheid over ten minste één geconfigureerd LIN-slavekanaal beschikt [SWS_LinIf_91007]. Als parameters worden de kanaalidentificatie Channel en de opgetreden foutstatus ErrorStatus van het type Lin_SlaveErrorType meegegeven [SWS_LinIf_91007].

Foutafhandeling en gelijktijdigheid

De functie is re-entrant voor verschillende kanalen, maar mag voor hetzelfde kanaal niet gelijktijdig worden aangeroepen [SWS_LinIf_91007]. Bij de aanroep beschouwt de LIN-interface de respons resp. het overgedragen frame als verloren en meldt de runtimefout LINIF_E_RESPONSE aan de Default Error Tracer (DET), tenzij de gemelde foutstatus LIN_ERR_HEADER luidt [SWS_LinIf_00735], [SWS_LinIf_00743].

Samenspel en busbewaking

Onafhankelijk van de meegegeven foutcode herlaadt de LIN-interface bij elke aanroep van LinIf_LinErrorIndication de lopende bus-idle-timer [SWS_LinIf_00754]. Treedt een fout op bij een SRF-respons na ontvangst van een SRF-header, dan breekt de LIN-interface de overdracht af en meldt dit aan de bovenste laag via PduR_LinTpTxConfirmation met het resultaat E_NOT_OK [SWS_LinIf_00796].

Als bus-mirroring via LinIfBusMirroringSupported globaal actief en voor het kanaal ingeschakeld is, leidt de LIN-interface fouten ongelijk aan LIN_ERR_HEADER door via Mirror_ReportLinFrame() met een NULL-pointer voor de data-inhoud [SWS_LinIf_00869]. Hierbij worden de driverfoutcodes vooraf vertaald naar overeenkomstige statuswaarden van het type Lin_StatusType [SWS_LinIf_00870].

De configureerbare interface <User_TriggerTransmit> dient voor het synchroon opvragen van SDU-gegevens uit een bovenliggende module voor een op handen zijnde overdracht [SWS_LinIf_00528].

Via de parameter TxPduId wordt de aangevraagde SDU geïdentificeerd, terwijl PduInfoPtr als pointer naar een structuur met de doelbuffer (SduDataPtr) en de beschikbare buffergrootte (SduLength) wordt doorgegeven [SWS_LinIf_00528]. De aangeroepen bovenliggende module controleert binnen deze API of de klaestaande gegevens in de gemelde buffergrootte passen [SWS_LinIf_00528]. Als er voldoende ruimte beschikbaar is, kopieert de module zijn gegevens naar SduDataPtr, werkt SduLength bij met het aantal daadwerkelijk gekopieerde bytes en signaleert het succes met de retourwaarde E_OK [SWS_LinIf_00528].

Als de buffergrootte daarentegen niet toereikend is, worden er geen SDU-gegevens gekopieerd en retourneert de module E_NOT_OK zonder PduInfoPtr te wijzigen [SWS_LinIf_00528]. Bij een retourwaarde van E_NOT_OK mag de aanroeper PduInfoPtr onder geen beding gebruiken, omdat deze naar ongeldige gegevens kan verwijzen of een NULL-pointer kan zijn [SWS_LinIf_00528].

Wat de gelijktijdigheid betreft, is de functie re-entrant voor verschillende PDU-ID's, maar niet-re-entrant voor dezelfde PDU-ID [SWS_LinIf_00528].

De configureerbare callback-functie <User_TxConfirmation> wordt door de onderliggende communicatie-interfacemodule aangeroepen om de overdracht van een PDU of het mislukken van de overdracht te bevestigen aan een hogere laag [SWS_LinIf_00529]. De aanroep vindt synchroon plaats en levert geen retourwaarde op [SWS_LinIf_00529].

Parameters en semantiek

• TxPduId (In): Duidt de identifier aan van de overgedragen PDU van het type PduIdType [SWS_LinIf_00529].
• result (In): Meldt de successtatus van de overdracht als Std_ReturnType met de waarden E_OK bij succesvolle PDU-overdracht of E_NOT_OK bij mislukte overdracht [SWS_LinIf_00529].

Gelijktijdigheid en foutafhandeling

Wat betreft re-entrantie is de functie re-entrant ontworpen voor verschillende PDU-ID's, maar mag voor dezelfde PDU-ID niet re-entrant worden aangeroepen [SWS_LinIf_00529]. De module specificeert voor deze interface geen afzonderlijke foutcodes of DET- resp. DEM-meldingen; het mislukken van een overdracht wordt in plaats daarvan aangegeven via de parameterwaarde E_NOT_OK [SWS_LinIf_00529]. De feitelijke functienaam zal vermoedelijk integratiespecifiek worden vastgelegd afhankelijk van de geconfigureerde gebruikerslaag, aangezien de service als configureerbaar is aangegeven [SWS_LinIf_00529]. Vraag Q-35de931161f26cb8 (open)

De callback-functie <User_RxIndication> dient voor het signaleren van een ontvangen PDU van een onderliggende communicatie-interfacemodule aan de bovenliggende laag [SWS_LinIf_00530]. De aanroep vindt plaats met synchrone semantiek en heeft geen retourwaarde [SWS_LinIf_00530].

Parameters en interfacespecificatie

De functie geeft twee ingangsparameters door aan de hogere laag [SWS_LinIf_00530]:

• RxPduId: Identifier van de ontvangen PDU van het type PduIdType [SWS_LinIf_00530].
• PduInfoPtr: Pointer naar een structuur van het type PduInfoType, die de lengte van de payload (SduLength), een pointer naar de buffer met de payload (SduDataPtr) alsmede bijbehorende metagegevens van de PDU levert [SWS_LinIf_00530].

Noch in-/uitgangsparameters noch zuivere uitgangsparameters zijn voor deze interface voorzien [SWS_LinIf_00530].

Gelijktijdigheid en configuratie

Wat betreft re-entrantie is de functie re-entrant ontworpen voor verschillende PDU-ID's, maar voor identieke PDU-ID's expliciet als niet-re-entrant gespecificeerd [SWS_LinIf_00530]. Aanroepers moeten er daarom voor zorgen dat er voor dezelfde RxPduId geen overlappende aanroepen plaatsvinden. De functie is gedeclareerd als configureerbare interface [SWS_LinIf_00530]; de concrete functienaam van de hogere laag zal vermoedelijk via de moduleconfiguratie worden vastgelegd. Vraag Q-94175e8cd86775b6 (open)

De interface <User_ResponseErrorSignalChanged> dient in de module LinIf als meldingsfunctie om een waardeverandering van het Response-Error-signaal met de nieuwe signaalwaarde te melden [SWS_LinIf_00856]. De aanroep vindt synchroon plaats en heeft het service-ID 0x74 [SWS_LinIf_00856]. Er zijn noch in-/uitgangsparameters noch een retourwaarde voorzien; de signatuur is gedefinieerd met het retourtype void [SWS_LinIf_00856].

Als overdrachtsparameters verwacht de functie twee zuivere ingangswaarden [SWS_LinIf_00856]:

• Channel (type NetworkHandleType): Unieke identificatie van het betreffende LIN-kanaal [SWS_LinIf_00856].
• RespErrSigValue (type boolean): Actuele waarde van het Response-Error-signaal. De parameter is true wanneer het signaal op 1 is gezet, anders false [SWS_LinIf_00856].

Wat betreft gelijktijdigheid en aanroepcontext is vastgelegd dat de functie re-entrant is voor verschillende kanalen, maar niet re-entrant mag worden aangeroepen voor hetzelfde kanaal [SWS_LinIf_00856]. Een functionele randvoorwaarde is dat deze meldingsservice uitsluitend van toepassing is op LIN-slave-nodes [SWS_LinIf_00856]. De declaratie wordt via het headerbestand LinIf_Externals.h beschikbaar gesteld [SWS_LinIf_00856].

De callback-functie <User_SaveConfigurationRequest> (service-ID 0x75) informeert een bovenliggende laag over de ontvangst van een “Save Configuration”-request en is gedeclareerd in LinIf_Externals.h [SWS_LinIf_00857]. Deze interface is uitsluitend toepasbaar voor LIN-slave-nodes [SWS_LinIf_00857].

De aanroep vindt synchroon plaats en is als re-entrant gespecificeerd [SWS_LinIf_00857]:

• Parameters: Via de ingangsparameter Channel van het type NetworkHandleType wordt het betreffende LIN-kanaal meegegeven [SWS_LinIf_00857]. Aanvullende in- of uitgangsparameters bestaan niet [SWS_LinIf_00857].
• Retourwaarde: De functie levert een waarde van het type boolean op [SWS_LinIf_00857]. De retourwaarde TRUE signaleert dat een positieve respons op de LIN-bus moet worden verzonden, terwijl FALSE de overdracht van elke respons onderdrukt [SWS_LinIf_00857].

Wat betreft foutafhandeling definieert de specificatie noch specifieke foutcodes noch DET- of DEM-meldingen [SWS_LinIf_00857]. Het gedrag in geval van een fout of afwijzing wordt direct gestuurd via de booleaanse retourwaarde, doordat door FALSE het verzenden van een respons wordt verhinderd [SWS_LinIf_00857]. Aangezien de aanroep als re-entrant is geclassificeerd, zal de functie vermoedelijk zijn ontworpen voor gelijktijdige aanroep op verschillende kanalen [SWS_LinIf_00857]. Vraag Q-84432030c1aff644 (open)

Het opsommingstype LinTp_Mode is gedefinieerd in het headerbestand LinIf.h en bepaalt welke schedule-tabelmodus tijdens een diagnosesessie door het LIN-transportprotocol (LIN TP) kan worden aangevraagd [SWS_LinIf_00629].

Het waardebereik omvat drie enumeratieliterals voor het aansturen van de schedule-wissel op de LIN-bus [SWS_LinIf_00629]:

• LINTP_APPLICATIVE_SCHEDULE: selecteert de applicatieve schedule-tabel voor het reguliere berichtenverkeer [SWS_LinIf_00629].
• LINTP_DIAG_REQUEST: selecteert de master-request-schedule-tabel voor de overdracht van diagnoseverzoeken [SWS_LinIf_00629].
• LINTP_DIAG_RESPONSE: selecteert de slave-response-schedule-tabel voor de ontvangst van diagnoseantwoorden [SWS_LinIf_00629].

Wat betreft de interactie dient het type voor het omschakelen tussen diagnoseoverdrachten en reguliere applicatiecommunicatie binnen het LIN-interface [SWS_LinIf_00629]. Specifieke aanroepcontexten, re-entrantie-eigenschappen of foutafhandelingen (zoals DET- of DEM-meldingen) zijn voor dit zuivere datatype in de bronnen niet aangegeven; vermoedelijk wordt het type als functieparameter bij besturingsaanroepen door het LIN-transportprotocol aan het LIN-interface overgedragen. Vraag Q-1bf7553401882471 (open)