LIN Transceiver Driver (LinTrcv)

De LIN Transceiver Driver bestuurt de fysieke LIN-transceiver van een kanaal en ontkoppelt LinIf van de hardware. Volgens LinTrcv_Init is de uitgangsmodus SLEEP. LinTrcv_SetOpMode schakelt tussen NORMAL, STANDBY en SLEEP en retourneert bij een mislukte wissel E_NOT_OK [SWS_LinTrcv_00002]. Externe wake-ups worden gedetecteerd via de ICU en gemeld wanneer LinIf LinTrcv_CheckWakeup aanroept. In R20-11 betekent E_OK hierbij „wake-up gedetecteerd” [SWS_LinTrcv_00012]. Wachttijden voor toestandswissels moeten worden gerealiseerd met Tm_BusyWait1us16bit.

meer ›

De LIN Transceiver Driver bestuurt de fysieke LIN-transceiver van een kanaal en ontkoppelt de LIN-interface van de hardware. LinIf roept zijn services direct aan: LinIf_SetTrcvMode roept bijvoorbeeld LinTrcv_SetOpMode aan en retourneert het resultaat daarvan ongewijzigd [SWS_LinTrcv_00002] LinIf-SWS p. 90. Software- en hardwaretoestanden zijn gescheiden. Welke hardwaretoestanden door een softwaremodus worden gedekt, bepaalt de implementatie LinTrcv-SWS p. 16.

Het stuurprogramma kent de modi LINTRCV_TRCV_MODE_NORMAL, LINTRCV_TRCV_MODE_STANDBY en LINTRCV_TRCV_MODE_SLEEP [SWS_LinTrcv_00168]. Na het inschakelen is het inactief. LinTrcv_Init activeert het met een configuratieset [SWS_LinTrcv_00001]; de uitgangsmodus is SLEEP LinTrcv-SWS p. 1. STANDBY is optioneel en kan een louter interne toestand zijn LinTrcv-SWS Afb. 7.1 p. 15.

Toestandsdiagram: Levenscyclus vanaf power-on via LinTrcv_Init tot de moduswissels met LinTrcv_SetOpMode. De optionele overgangen zijn gereconstrueerd (interpretatie). Bronnen: LinTrcv-SWS Afb. 7.1 p. 15 [SWS_LinTrcv_00168]

Externe wake-ups detecteert het stuurprogramma niet via een eigen ISR, maar via de ICU LinTrcv-SWS p. 17. LinIf vraagt deze op met LinTrcv_CheckWakeup. In R20-11 betekent E_OK hierbij „wake-up gedetecteerd” [SWS_LinTrcv_00012]. Latere releases definiëren dit anders. Een gedetecteerde wake-up wordt gemeld via LinIf_WakeupConfirmation [SWS_LinTrcv_91002]. LinTrcv_SetWakeupMode geeft de notificatie vrij, blokkeert deze of wist opgeslagen gebeurtenissen [SWS_LinTrcv_00169].

Sequentiediagram: Externe wake-up vanaf de ICU-detectie via LinTrcv_CheckWakeup en LinIf_WakeupConfirmation tot aan het opvragen van de reden. Bronnen: [SWS_LinTrcv_00012] [SWS_LinTrcv_91002] LinTrcv-SWS p. 17

Voor de werking gelden de volgende randvoorwaarden:

• Wachttijden bij toestandswissels moeten worden gerealiseerd met Tm_BusyWait1us16bit [SWS_LinTrcv_00171].
• Op multi-coresystemen moeten LinTrcvChannel en LinChannel van een kanaal naar dezelfde partitie verwijzen [SWS_LinTrcv_00177].
• Bij verstoorde communicatie met de transceiver leveren de opvragingen E_NOT_OK op LinTrcv-SWS p. 26.

De DET-foutcodes zijn alleen aangetoond vanuit latere releases. Aangezien R21-11 de foutcodes heeft opgeschoond, kunnen hun namen in R20-11 afwijken LinTrcv-SWS p. 1.

meer ›

Rol tussen LIN-interface en transceivercomponent

De LIN Transceiver Driver (LinTrcv) kapselt de aansturing van de fysieke LIN-transceiver in. Zijn interface bestaat uit zeven services:

• Initialisatie met LinTrcv_Init [SWS_LinTrcv_00001]
• Moduswissel met LinTrcv_SetOpMode [SWS_LinTrcv_00002]
• Opvragen van de modus met LinTrcv_GetOpMode [SWS_LinTrcv_00005]
• Opvragen van de wake-upreden met LinTrcv_GetBusWuReason [SWS_LinTrcv_00007]
• Aansturing van de wake-upnotificatie met LinTrcv_SetWakeupMode [SWS_LinTrcv_00009]
• Wake-upcontrole met LinTrcv_CheckWakeup [SWS_LinTrcv_00012]
• Versie-opvraag met LinTrcv_GetVersionInfo [SWS_LinTrcv_00008]

Alle services zijn synchroon. De softwaretoestanden van het stuurprogramma zijn gescheiden van de hardwaretoestanden van de component. De component mag meer overgangen kennen dan het stuurprogramma. Welke hardwaretoestanden door een softwaretoestand worden gedekt, bepaalt de implementatie. Deze moet echter de beschreven functionaliteit volledig leveren LinTrcv-SWS p. 16.

Naar boven toe is de LIN-interface (LinIf) de in de payload vastgelegde gebruiker. De LinIf-services roepen telkens een LinTrcv-service aan:

• LinIf_SetTrcvMode roept LinTrcv_SetOpMode aan en retourneert de retourwaarde daarvan ongewijzigd LinIf-SWS p. 90.
• LinIf_GetTrcvMode roept LinTrcv_GetOpMode aan LinIf-SWS p. 91.
• LinIf_GetTrcvWakeupReason roept LinTrcv_GetBusWuReason aan LinIf-SWS p. 92.
• LinIf_SetTrcvWakeupMode roept LinTrcv_SetWakeupMode aan LinIf-SWS p. 93.

De typen LinTrcv_TrcvModeType en LinTrcv_TrcvWakeupModeType zijn beschikbaar via Lin_GeneralTypes.h [SWS_LinTrcv_00168] [SWS_LinTrcv_00169]. LinIf gebruikt ze direct in zijn signaturen. Het eerdere eigen type LinIf_TrcvModeType werd in versie 3.1.5 vervangen door LinTrcv_TrcvModeType LinIf-SWS p. 4.

Naar beneden toe maakt het stuurprogramma gebruik van de volgende services:

• de lees- en schrijfdiensten van Dio, Det_ReportError en EcuM_SetWakeupEvent [SWS_LinTrcv_91003]
• typen uit Dio, Spi, Icu en EcuM [SWS_LinTrcv_91001]
• Icu_EnableNotification en Icu_DisableNotification voor de wake-upnotificatie LinTrcv-SWS p. 17
• de tijddienst Tm_BusyWait1us16bit voor wachttijden bij toestandswissels [SWS_LinTrcv_00171]

Gedetecteerde wake-ups meldt het stuurprogramma via LinIf_WakeupConfirmation aan LinIf [SWS_LinTrcv_91002]. LinIf zet vervolgens de wake-upvlag van het desbetreffende kanaal LinIf-SWS p. 98.

Contextdiagram: LinTrcv bevindt zich tussen LinIf en de hardwarenabije services Dio/Spi, Icu en Tm en meldt wake-ups terug aan LinIf. Bronnen: [SWS_LinTrcv_91001] [SWS_LinTrcv_91002] [SWS_LinTrcv_91003] [SWS_LinTrcv_00171] LinTrcv-SWS p. 17 LinTrcv-SWS Afb. 10.3 p. 45

Levenscyclus van de bedrijfsmodi van power-on tot sleep

Het stuurprogramma kent drie software-bedrijfsmodi: LINTRCV_TRCV_MODE_NORMAL, LINTRCV_TRCV_MODE_STANDBY en LINTRCV_TRCV_MODE_SLEEP [SWS_LinTrcv_00168]. Afbeelding 7.1 van de specificatie plaatst deze in een levenscyclus LinTrcv-SWS Afb. 7.1 p. 15:

• Na het inschakelen bevindt het stuurprogramma zich in de toestand NOT_ACTIVE.
• LinTrcv_Init brengt het over naar de toestand ACTIVE. De drie modi liggen binnen ACTIVE.
• Spanningsverlies beëindigt de levenscyclus.

LinTrcv_Init ontvangt een pointer naar de gekozen configuratieset [SWS_LinTrcv_00001]. De structuur LinTrcv_ConfigType is implementatiespecifiek [SWS_LinTrcv_00172]. Sinds versie 4.3.1 is de uitgangsmodus na de initialisatie beperkt tot LINTRCV_TRCV_MODE_SLEEP LinTrcv-SWS p. 1.

In de toestand ACTIVE schakelt LinTrcv_SetOpMode de interne toestand van het geadresseerde kanaal naar de meegegeven modus [SWS_LinTrcv_00002] LinTrcv-SWS p. 25. De modus LINTRCV_TRCV_MODE_STANDBY is optioneel. Dit kan een louter interne toestand zijn die de hardware gebruikt voor overgangen. Een concrete hardware heeft mogelijk niet alle interfaces nodig LinTrcv-SWS Afb. 7.1 p. 15. De specificatie noemt bovendien voorwaarden waaronder LinTrcv_SetOpMode het kanaal naar STANDBY schakelt. Deze voorwaarden zijn in het onderhavige fragment afgekapt en worden hier niet verder uitgewerkt LinTrcv-SWS p. 25.

LinTrcv_GetOpMode levert in de uitvoerparameter OpMode de actuele softwaretoestand van het stuurprogramma op [SWS_LinTrcv_00005] LinTrcv-SWS p. 26. Dat is niet noodzakelijkerwijs de toestand van de component. Een aanroeper kan hiermee vóór een moduswissel controleren in welke modus het kanaal zich bevindt. Via LinIf is deze opvraag beschikbaar als LinIf_GetTrcvMode LinIf-SWS p. 91.

Toestandsdiagram: Na power-on is het stuurprogramma inactief. LinTrcv_Init leidt naar het actieve bereik met de uitgangsmodus SLEEP, LinTrcv_SetOpMode schakelt tussen de modi. De optionele overgangen zijn gereconstrueerd uit de bijschriften van afb. 7.1 (interpretatie). Voorwaardelijke overgangen naar STANDBY zijn niet weergegeven. Bronnen: LinTrcv-SWS Afb. 7.1 p. 15 [SWS_LinTrcv_00168] [SWS_LinTrcv_00001] LinTrcv-SWS p. 1

Moduswissels en opvragingen via de LIN-interface

Elke service adresseert een kanaal via de parameter LinNetwork van het type uint8 [SWS_LinTrcv_00002] [SWS_LinTrcv_00005]. In LinIf heet de overeenkomstige parameter Channel en heeft deze het type NetworkHandleType LinIf-SWS p. 90.

LinTrcv_SetOpMode is synchroon en niet-re-entrant, het service-ID is 0x01. De retourwaarden betekenen [SWS_LinTrcv_00002]:

• E_OK: De transceivertoestand is gewisseld naar de aangevraagde modus.
• E_NOT_OK: De wissel is niet geaccepteerd, is mislukt, of de parameter valt buiten het toegestane bereik.

LinIf moet de aanroep voor alle transceivers en alle modi toestaan, zelfs als de hardware een modus niet ondersteunt LinIf-SWS p. 90. De vertaling naar de hardware blijft daarmee een taak van LinTrcv.

Wachttijden bij toestandswissels realiseert het stuurprogramma met Tm_BusyWait1us16bit [SWS_LinTrcv_00171]. Aangezien LinTrcv_SetOpMode synchroon werkt [SWS_LinTrcv_00002], zal deze actieve wachttijd vermoedelijk binnen de aanroep vallen en de uitvoeringstijd ervan verlengen (interpretatie). Vraag Q-54fe21bbe7c737d9 (open) Bij het wisselen naar de stand-bymodus activeert het stuurprogramma bovendien de ICU-kanalen voor wake-updetectie LinTrcv-SWS p. 17.

De opvraagservices zijn re-entrant. LinTrcv_GetBusWuReason levert de gedetecteerde wake-upreden op in het type LinTrcv_TrcvWakeupReasonType [SWS_LinTrcv_00007]. Tot de waarden daarvan behoren LINTRCV_WU_ERROR, LINTRCV_WU_NOT_SUPPORTED, LINTRCV_WU_BY_BUS en LINTRCV_WU_BY_PIN [SWS_LinTrcv_00170]. Hoe nauwkeurig wake-upredenen kunnen worden onderscheiden, hangt sterk af van de transceiverhardware LinTrcv-SWS p. 28. LinTrcv_GetVersionInfo geeft de versie-informatie terug als Std_VersionInfoType [SWS_LinTrcv_00008] LinTrcv-SWS p. 29.

Sequentiediagram: Een moduswissel verloopt van LinIf naar LinTrcv. LinTrcv wacht via Tm, activeert bij de overgang naar STANDBY de ICU-notificatie en geeft zijn resultaat via LinIf ongewijzigd terug. De aansturing via Dio/Spi en de plaatsing van de wachttijd binnen de aanroep zijn interpretatie. Bronnen: [SWS_LinTrcv_00002] [SWS_LinTrcv_00171] LinIf-SWS p. 90 LinTrcv-SWS p. 17

Wake-up detecteren, melden en aansturen

Het stuurprogramma onderscheidt twee soorten wake-ups LinTrcv-SWS p. 17:

• Interne wake-up: Een hogere laag triggert deze, bijvoorbeeld door LinTrcv_Init of LinTrcv_SetOpMode.
• Externe wake-up: Het stuurprogramma detecteert deze op het LIN-kanaal. LinIf moet LinTrcv_CheckWakeup aanroepen om de wake-up naar boven te melden.

Het stuurprogramma voorziet niet in een eigen ISR voor de wake-up. De detectie verloopt via de ICU met Icu_EnableNotification en Icu_DisableNotification. Het type wake-up wordt geselecteerd via de configuratieparameter LinTrcvWakeUpSupport. Met LinTrcvWakeupByBusUsed kan de wake-upondersteuning per kanaal worden in- en uitgeschakeld LinTrcv-SWS p. 17.

LinTrcv_CheckWakeup evalueert de wake-up op het geadresseerde netwerk, zoals een dominant busniveau of een neergaande flank op de wake-uppin LinTrcv-SWS p. 30. In R20-11 betekenen de retourwaarden [SWS_LinTrcv_00012]:

• E_OK: Er is een wake-up gedetecteerd.
• E_NOT_OK: Er is geen wake-up gedetecteerd.

De documentpassage uit latere releases definieert de waarden anders, namelijk als „aanroep geaccepteerd/niet geaccepteerd”. Deze wijziging werd geïntroduceerd met R22-11 en geldt niet voor R20-11 LinTrcv-SWS p. 1 LinTrcv-SWS p. 30. Na een succesvolle detectie meldt het stuurprogramma de wake-upbron via LinIf_WakeupConfirmation [SWS_LinTrcv_91002]. LinTrcv biedt geen eigen callback-notificaties aan LinTrcv-SWS p. 32. Daarom moet LinTrcv_CheckWakeup actief worden aangeroepen.

LinTrcv_SetWakeupMode is synchroon en niet-re-entrant. Het bestuurt de wake-upnotificatie per netwerk via LinTrcv_TrcvWakeupModeType [SWS_LinTrcv_00009] [SWS_LinTrcv_00169]:

• LINTRCV_WUMODE_ENABLE geeft de notificatie vrij.
• LINTRCV_WUMODE_DISABLE blokkeert deze.
• LINTRCV_WUMODE_CLEAR wist een opgeslagen wake-upgebeurtenis.

Als er bij het vrijgeven al een opgeslagen gebeurtenis aanwezig is, voert het stuurprogramma de notificatie nog binnen de aanroep of onmiddellijk daarna uit LinTrcv-SWS p. 31. LinIf biedt deze besturing aan als LinIf_SetTrcvWakeupMode LinIf-SWS p. 93.

Sequentiediagram: Een externe wake-up wordt gedetecteerd via de ICU. LinIf controleert deze met LinTrcv_CheckWakeup, LinTrcv bevestigt deze via LinIf_WakeupConfirmation en de reden kan daarna worden opgevraagd (retourwaarden volgens R20-11). Bronnen: [SWS_LinTrcv_00012] [SWS_LinTrcv_91002] [SWS_LinTrcv_00007] LinTrcv-SWS p. 17 LinIf-SWS p. 98

Activiteitendiagram: LinTrcv_SetWakeupMode vertakt op basis van de gevraagde modus. Alleen bij ENABLE met een opgeslagen gebeurtenis volgt direct een notificatie. Bronnen: [SWS_LinTrcv_00009] [SWS_LinTrcv_00169] LinTrcv-SWS p. 31

Hardwaretoegang, kanaalconfiguratie en partitionering

Hoe het stuurprogramma de component bereikt, wordt bepaald door de selectiecontainer LinTrcvAccess LinTrcv-SWS Afb. 10.3 p. 45. Precies één van twee varianten moet worden gekozen:

• LinTrcvDioAccess: De transceiverpinnen worden toegewezen aan DIO-kanalen.
• LinTrcvSpiSequence: Een SPI-compatibele component wordt aangesproken via een SPI-sequentie.

Het schema is afkomstig uit R23-11 en latere releases. De DIO-lees- en schrijfdiensten en de SPI-typen worden echter al in R20-11 genoemd als gebruikte interfaces respectievelijk geïmporteerde typen [SWS_LinTrcv_91003] [SWS_LinTrcv_91001].

Voor multi-coresystemen gelden in R20-11 de volgende regels:

• Het stuurprogramma moet configuraties met niet-ondersteunde partitietoewijzingen afwijzen [SWS_LinTrcv_00174].
• De via LinTrcvChannelEcucPartitionRef gerefereerde partities moeten een deelverzameling zijn van de via LinTrcvEcucPartitionRef gerefereerde partities. Indien de module naar partities verwijst, moet elk kanaal naar precies één daarvan verwijzen [SWS_LinTrcv_00176].
• LinTrcvChannel en LinChannel van hetzelfde communicatiekanaal moeten naar dezelfde partitie verwijzen [SWS_LinTrcv_00177].

De multicoredistributie is toegevoegd met R19-11 en werd gepreciseerd in R24-11 LinTrcv-SWS p. 1.

Gedrag in het foutgeval

Runtimefouten blijken uit de retourwaarde:

• Bij ontbrekende of verstoorde communicatie met de transceiver leveren LinTrcv_GetOpMode LinTrcv-SWS p. 26 en LinTrcv_GetBusWuReason LinTrcv-SWS p. 28 E_NOT_OK op.
• LinTrcv_SetOpMode levert E_NOT_OK op wanneer een overgang niet is geaccepteerd of is mislukt [SWS_LinTrcv_00002].
• LinTrcv_SetWakeupMode levert E_NOT_OK op wanneer de wakeupmodus niet kon worden ingesteld LinTrcv-SWS p. 31.
• Als een wakeupreden wegens een fout niet kan worden bepaald, staat daarvoor de waarde LINTRCV_WU_ERROR ter beschikking [SWS_LinTrcv_00170].

Ontwikkelfouten meldt de driver via Det_ReportError [SWS_LinTrcv_91003]. In R20-11 leiden ze bij LinTrcv_GetOpMode en LinTrcv_GetBusWuReason tot E_NOT_OK [SWS_LinTrcv_00005] [SWS_LinTrcv_00007]. De documentpassages uit latere releases noemen concrete controles LinTrcv-SWS p. 26 LinTrcv-SWS p. 30 LinTrcv-SWS p. 29:

• Aanroep vóór de initialisatie: LINTRCV_E_UNINIT
• ongeldig netwerknummer: LINTRCV_E_INVALID_LIN_NETWORK
• Null-pointer bij LinTrcv_GetVersionInfo: LINTRCV_E_PARAM_POINTER

Deze controles gelden inhoudelijk vermoedelijk ook voor R20-11 (interpretatie). Vraag Q-58e3d310b525b810 (open) R20-11 heeft echter de foutclassificatie gesaneerd en R21-11 de foutcodes. De identifiers kunnen in R20-11 daarom afwijken LinTrcv-SWS p. 1.

Een deel van de bedieningsfouten vangt LinIf al af. Bij een ongeldige Channel melden LinIf_SetTrcvMode en LinIf_GetTrcvMode de fout LINIF_E_NONEXISTENT_CHANNEL LinIf-SWS p. 90. LinIf_GetTrcvMode levert bij een ongeldig kanaal of een null-pointer bovendien E_NOT_OK LinIf-SWS p. 91 op. Ontvangt LinIf_WakeupConfirmation een ongeldige wakeupbron, dan triggert deze bij geactiveerde foutdetectie LINIF_E_PARAM_WAKEUPSOURCE LinIf-SWS p. 98.

Verdere gedetailleerde bewijzen

• [SWS_LinTrcv_00002] met LinTrcv-SWS p. 25: modusovergangen, retourwaarden en overgang naar STANDBY.
• [SWS_LinTrcv_00012] met LinTrcv-SWS p. 30: wakeupcontrole. De retourwaarden in R20-11 wijken af van latere releases.
• [SWS_LinTrcv_00009] [SWS_LinTrcv_00169] met LinTrcv-SWS p. 31: wakeupnotificatie vrijgeven, blokkeren en wissen.
• [SWS_LinTrcv_00168] met LinTrcv-SWS Afb. 7.1 p. 15: bedrijfsmodi en levenscyclus.
• [SWS_LinTrcv_00170] met LinTrcv-SWS p. 28: wakeupredenen en hun afhankelijkheid van de hardware.
• [SWS_LinTrcv_00171]: wachttijden via Tm_BusyWait1us16bit.
• [SWS_LinTrcv_00174] [SWS_LinTrcv_00176] [SWS_LinTrcv_00177]: partitionering op multicore-ECU's.
• [SWS_LinTrcv_91001] [SWS_LinTrcv_91002] [SWS_LinTrcv_91003]: geïmporteerde types, wakeupbevestiging aan LinIf en andere gebruikte interfaces.
• LinTrcv-SWS p. 17: interne en externe wakeups, ICU-gebruik en wakeupconfiguratie.