LIN Interface (LinIf)

Die synchrone Funktion LinIf_Init dient der Initialisierung des LIN-Interface gemäß [SWS_LinIf_00198]. Die Schnittstelle besitzt die Service-ID 0x01, ist über die Header-Datei LinIf.h verfügbar und wird synchron ausgeführt.

Aufrufkontext und Parameter

Die Funktion erwartet als einzigen Parameter ConfigPtr (const LinIf_ConfigType*), welcher als Zeiger auf die Konfiguration des LIN-Interface dient [SWS_LinIf_00198]. Sie besitzt keinen Rückgabewert und verfügt über keine Ein-/Ausgangs- oder reinen Ausgangsparameter.

Initialisierungsabläufe und Zusammenspiel

Im Rahmen der Initialisierung nimmt das LIN-Interface spezifische Einstellungen für Slave-Knoten vor:

• Gemäß [SWS_LinIf_00767] initialisiert das Modul in LinIf_Init die initiale Knotenadresse (initial NAD) und die konfigurierte Knotenadresse (configured NAD) des Slave-Knotens anhand der Konfigurationsparameter LinIfInitialNAD und LinIfConfiguredNAD.
• Gemäß [SWS_LinIf_00768] initialisiert das Modul in LinIf_Init die konfigurierten PIDs des Slave-Knotens aus den Konfigurationsdaten über die Konfigurationsparameter LinIfFrameId.

Nebenläufigkeit und Einschränkungen

Die Funktion ist als nicht reentrant (Non Reentrant) spezifiziert [SWS_LinIf_00198]. Ein nebenläufiger oder überlappender Aufruf ist daher unzulässig. Spezifische Fehlercodes oder DET-Meldungen sind im bereitgestellten Spezifikationsumfang für diesen Dienst nicht ausgewiesen.

Verwendung und Aufrufkontext

Die in LinIf.h deklarierte Funktion LinIf_Transmit (Service-ID 0x49) dient der synchronen Anforderung zur Übertragung einer PDU [SWS_LinIf_00201]. Als Eingangsparameter erwartet sie TxPduId zur eindeutigen Identifikation der zu sendenden PDU sowie den Zeiger PduInfoPtr auf eine PduInfoType-Struktur, die neben der Datenlänge und den eigentlichen Nutzdaten auch Metadaten referenzieren kann [SWS_LinIf_00201]. Zusätzliche Ein-/Ausgangs- oder Ausgabeparameter existieren nicht [SWS_LinIf_00201].

Rückgabewerte und Verhaltensanforderungen

Als Rückgabewert liefert der Dienst den Status Std_ReturnType [SWS_LinIf_00201]:

• E_OK: Die Übertragungsanforderung wurde durch das LIN-Interface erfolgreich angenommen [SWS_LinIf_00201].
• E_NOT_OK: Die Anforderung zur Übertragung konnte nicht angenommen werden [SWS_LinIf_00201].

Das Zusammenspiel mit den Frame-Typen wird durch [SWS_LinIf_00700] präzisiert: Bei initialisiertem LIN-Interface gibt LinIf_Transmit auch dann E_OK zurück, wenn die PDU zu einem nicht-sporadischen Frame auf einem LIN-Master-Knoten oder zu einem nicht-ereignisgesteuerten Frame auf einem LIN-Slave-Knoten gehört.

Nebenläufigkeit

In Bezug auf die Ausführungsumgebung ist LinIf_Transmit reentrant für unterschiedliche PDU-IDs, darf jedoch für dieselbe TxPduId nicht zeitgleich bzw. nebenläufig aufgerufen werden [SWS_LinIf_00201].

Die Funktion LinIf_ScheduleRequest dient ausschließlich auf LIN-Master-Knoten dazu, die Ausführung einer vorgegebenen Schedule-Tabelle anzufordern [SWS_LinIf_00202]. Der Aufruf wird asynchron verarbeitet und ist reentrant ausgelegt [SWS_LinIf_00202].

Parameter und Rückgabewerte

Über den Parameter Channel wird der betroffene LIN-Kanalindex übergeben, während Schedule die Identifikation der neu auszuführenden Schedule-Tabelle festlegt [SWS_LinIf_00202]. Die Funktion liefert den Status als Std_ReturnType zurück:

• E_OK: Der Wechselauftrag für die Schedule-Tabelle wurde erfolgreich entgegengenommen [SWS_LinIf_00202].
• E_NOT_OK: Die Umschaltung wurde abgelehnt [SWS_LinIf_00202].

Fehlerbedingungen und Einschränkungen

Ein Rückgabewert von E_NOT_OK tritt gemäß Spezifikation in folgenden Fehlerfällen auf [SWS_LinIf_00202]:

• Das LIN-Interface ist noch nicht initialisiert.
• Der referenzierte Kanal existiert nicht bzw. der übergebene Index liegt außerhalb des Wertebereichs.
• Die referenzierte Schedule-Tabelle existiert nicht bzw. deren Kennung ist ungültig.
• Der aktuelle Zustand ist Sleep.

Zusammenspiel

Das Scheitern einer Schedule-Anforderung wirkt sich auf übergeordnete Transportabläufe aus: Wird im Rahmen eines LinTp_Transmit-Aufrufs über BswM_LinTp_RequestMode ein Schedule-Wechsel via LinIf_ScheduleRequest initiiert, muss LinTp_Transmit zwingend E_NOT_OK zurückgeben, wenn LinIf_ScheduleRequest mit E_NOT_OK antwortet [SWS_LinIf_00878].

Verwendung

Die Funktion LinIf_GotoSleep (Service-ID 0x06, deklariert in LinIf.h) initiiert den Übergang in den Sleep-Modus auf dem spezifizierten LIN-Kanal [SWS_LinIf_00204]. Der Aufruf erfolgt asynchron und übernimmt als Eingangsparameter Channel vom Typ NetworkHandleType die Kennung des betreffenden Kanals [SWS_LinIf_00204].

Rückgabewerte und Fehlerbehandlung

Als Rückgabewert liefert der Dienst den Typ Std_ReturnType mit folgenden Bedeutungen [SWS_LinIf_00204]:

• E_OK: Die Anforderung zum Wechsel in den Sleep-Modus wurde erfolgreich akzeptiert, der Zustandsübergang in den Sleep-Modus läuft bereits oder der Controller befindet sich bereits im Sleep-Zustand [SWS_LinIf_00204].
• E_NOT_OK: Die Anforderung wurde nicht akzeptiert. Mögliche Ursachen hierfür sind ein noch nicht initialisiertes LIN-Interface oder ein nicht existierender bzw. außerhalb des gültigen Wertebereichs liegender Kanalbezeichner [SWS_LinIf_00204].

Nebenläufigkeit und Systemzusammenspiel

Die Schnittstelle ist als nicht reentrant (Non Reentrant) definiert [SWS_LinIf_00204]. Wird LinIf_GotoSleep aufgerufen, muss das LIN-Interface unmittelbar die Funktion Lin_GotoSleepInternal aufrufen und darf nicht bis zum nächsten Zyklus der Hauptfunktion warten [SWS_LinIf_00757].

Die reentrante Funktion LinIf_Wakeup stößt den asynchronen Aufwachprozess für den durch den Parameter Channel identifizierten LIN-Kanal an [SWS_LinIf_00205]. Sie steht über den Header LinIf.h zur Verfügung [SWS_LinIf_00205].

Der Rückgabewert Std_ReturnType gibt Aufschluss über die Annahme der Anforderung [SWS_LinIf_00205]:

• E_OK signalisiert, dass die Aufweckanforderung akzeptiert wurde oder sich der Controller bereits nicht mehr im Schlafzustand befindet [SWS_LinIf_00205].
• E_NOT_OK wird zurückgegeben, wenn das LIN Interface nicht initialisiert ist, die übergebene Kanal-ID außerhalb des gültigen Bereichs liegt oder die unterlagerten Treiberaufrufe Lin_Wakeup bzw. Lin_WakeupInternal mit E_NOT_OK fehlschlagen [SWS_LinIf_00205].

Das Zusammenspiel mit dem Benutzer erfolgt über die Rückmeldefunktion <User>_WakeupConfirmation:

• Im Fehlerfall ruft das LIN Interface vor der Rückgabe von E_NOT_OK zwingend <User>_WakeupConfirmation(FALSE) auf [SWS_LinIf_00762].
• Bei erfolgreicher Annahme (E_OK) bestätigt das LIN Interface das Aufwachen asynchron: Erst wenn nachfolgend zum ersten Mal die Funktion LinIf_HeaderIndication aufgerufen wird, setzt das Modul den Aufruf <User>_WakeupConfirmation(TRUE) ab [SWS_LinIf_00761].

Die synchrone und reentrante Funktion LinIf_SetTrcvMode (Service-ID 0x08) dient dem Umschalten des angegebenen LIN-Transceivers in den angeforderten Betriebsmodus [SWS_LinIf_00544]. Die Schnittstelle ist über die Header-Datei LinIf.h verfügbar [SWS_LinIf_00544].

Parameter und Rückgabewerte

Der Aufruf erfordert zwei Eingabeparameter [SWS_LinIf_00544]:

• Channel (NetworkHandleType): Identifiziert den zu steuernden LIN-Kanal [SWS_LinIf_00544].
• TransceiverMode (LinTrcv_TrcvModeType): Bestimmt den angeforderten Zustandsübergang des Transceivers [SWS_LinIf_00544].

Der Rückgabewert vom Typ Std_ReturnType signalisiert das Ergebnis des Umschaltvorgangs [SWS_LinIf_00544]:

• E_OK: Wird zurückgegeben, wenn der Transceiver-Zustand erfolgreich in den angeforderten Modus gewechselt wurde [SWS_LinIf_00544].
• E_NOT_OK: Signalisiert, dass die Zustandsänderung fehlgeschlagen ist oder mindestens ein Parameter außerhalb des zulässigen Bereichs liegt. Der vorherige Zustand des Transceivers bleibt unverändert [SWS_LinIf_00544].

Ausführung und Fehlerverhalten

Die Funktion wird synchron ausgeführt und ist als reentrant spezifiziert [SWS_LinIf_00544]. Spezifische DET- oder DEM-Fehlermeldungen sind im Spezifikationselement nicht separat aufgeführt; ein Fehlschlagen der Modusänderung oder unzulässige Parameterwerte führen unmittelbar zum Rückgabewert E_NOT_OK [SWS_LinIf_00544].

Die synchrone und reentrante Funktion LinIf_SetTrcvWakeupMode dient dazu, Benachrichtigungen für Wakeup-Ereignisse auf dem angegebenen LIN-Kanal zu aktivieren, zu deaktivieren oder zurückzusetzen [SWS_LinIf_00550]. Die Deklaration wird über den Header LinIf.h bereitgestellt und besitzt die Service-ID 0x0b [SWS_LinIf_00550].

Die Schnittstelle erwartet zwei Eingangsparameter [SWS_LinIf_00550]:

• Channel: Eindeutige Kennung des anzusprechenden LIN-Netzwerks bzw. -Kanals vom Typ NetworkHandleType [SWS_LinIf_00550].
• LinTrcvWakeupMode: Angeforderter Wakeup-Modus des Transceivers vom Typ LinTrcv_TrcvWakeupModeType [SWS_LinIf_00550].

Als Rückgabewert liefert die Funktion den Status Std_ReturnType [SWS_LinIf_00550]:

• E_OK: Der Aufruf des API-Dienstes des LIN-Transceiver-Treibers war erfolgreich und lieferte E_OK zurück [SWS_LinIf_00550].
• E_NOT_OK: Der API-Dienst des LIN-Transceiver-Treibers schlug fehl (Rückgabe E_NOT_OK) oder mindestens einer der übergebenen Parameter für Kanal oder Modus ist ungültig [SWS_LinIf_00550].

Hinsichtlich des Zusammenspiels delegiert die Funktion die Anforderung an den LIN-Transceiver-Treiber; vermutlich bildet das LinIf hierbei eine vermittelnde Schnittstelle zwischen oberen Schichten und der Transceiver-Hardware [SWS_LinIf_00550]. Frage Q-07b525a14a2c5fcd (offen) Da der Dienst als reentrant spezifiziert ist, darf er parallel für unterschiedliche oder denselben Kanal ausgeführt werden [SWS_LinIf_00550].

Verwendung und Aufrufkontext

Die Funktion LinTp_Init dient der Initialisierung der Transportschicht des LIN-Protokolls ([SWS_LinIf_00350]). Gemäß Spezifikation [SWS_LinIf_00350] arbeitet der Funktionsaufruf synchron.

Die Funktionssignatur lautet void LinTp_Init (const LinTp_ConfigType* ConfigPtr). Über den Eingangsparameter wird die Konfiguration übergeben:

• ConfigPtr (in): Zeiger auf die Konfigurationsdaten der LIN-Transportschicht vom Typ LinTp_ConfigType ([SWS_LinIf_00350]).

Die Funktion liefert keinen Rückgabewert (void) und definiert weder Ausgangs- noch Ein-/Ausgangsparameter ([SWS_LinIf_00350]). Sie besitzt die hexadezimale Service-ID 0x40 und wird über die Header-Datei LinIf.h bereitgestellt ([SWS_LinIf_00350]).

Fehlerbehandlung

Das Requirement [SWS_LinIf_00350] definiert für diese Funktion keine spezifischen Fehlercodes, DET-Meldungen oder DEM-Ereignisse. Es erfolgt keine Rückgabe eines Fehlerstatus an den Aufrufer ([SWS_LinIf_00350]).

Nebenläufigkeit und Einschränkungen

Die Funktion LinTp_Init ist explizit als nicht-reentrant (Non Reentrant) klassifiziert ([SWS_LinIf_00350]). Sie darf folglich nicht nebenläufig aus mehreren Threads, Tasks oder Unterbrechungsroutinen aufgerufen werden. Interpretation: Der Aufruf dürfte typischerweise zentral im Rahmen der Initialisierungssequenz der Basissoftware erfolgen, bevor nachfolgende Kommunikationsanforderungen verarbeitet werden können. Frage Q-6e391bdf8abb1a09 (offen)

Zusammenspiel

Für LinTp_Init sind im vorliegenden Auszug keine direkten Verknüpfungen zu weiteren Spezifikationsanforderungen oder Nachbarfunktionen aufgeführt ([SWS_LinIf_00350]). Das Modul LinIf stellt die Deklaration zur Verfügung ([SWS_LinIf_00350]).

Die synchrone Funktion LinTp_Transmit dient dem Anfordern einer PDU-Übertragung über das LIN-Transport-Protokoll ([SWS_LinIf_00351]). Als Übergabeparameter erwartet sie den PDU-Identifikator TxPduId sowie den Zeiger PduInfoPtr, der die Datenlänge sowie Zeiger auf die PDU-Daten und Metadaten bereitstellt ([SWS_LinIf_00351]). Der Rückgabewert ist E_OK bei erfolgreicher Annahme der Sendeanforderung und E_NOT_OK im Fall einer Ablehnung ([SWS_LinIf_00351]).

Das Laufzeitverhalten und das Zusammenspiel mit dem LIN Interface unterliegen folgenden Vorgaben:

• Schedule-Anforderung: Schlägt der im Rahmen des Aufrufs über BswM_LinTp_RequestMode veranlasste Schedule-Wechsel bei LinIf_ScheduleRequest fehl und liefert E_NOT_OK, muss auch LinTp_Transmit direkt mit E_NOT_OK antworten ([SWS_LinIf_00878]).
• Bestätigung: Nur wenn LinTp_Transmit erfolgreich war (Rückgabewert E_OK), ruft das LIN Interface nach erfolgreichem oder fehlgeschlagenem Schedule-Table-Wechsel die Funktion PduR_LinTpTxConfirmation mit positivem oder negativem Ergebnis auf ([SWS_LinIf_00702]). Bei abgewiesenem Sendeauftrag unterbleibt dieser Aufruf vollständig ([SWS_LinIf_00702]).
• Unterbrechung laufender Vorgänge: Wird während des Wartens auf eine physikalische Antwort oder während des Antwortempfangs ein neuer physikalischer Request über LinTp_Transmit ausgelöst, bricht das LIN Interface die laufende TP-Behandlung samt Empfang sowie N_Cr- und P2-Timeout-Überwachung ab und akzeptiert den neuen Request ([SWS_LinIf_00708]).

Hinsichtlich der Nebenläufigkeit ist LinTp_Transmit für unterschiedliche TxPduId reentrant, darf jedoch für dieselbe TxPduId nicht nebenläufig ausgeführt werden ([SWS_LinIf_00351]).

Die Funktion LinTp_Shutdown dient dem kontrollierten Herunterfahren des LIN-Transportprotokolls ([SWS_LinIf_00355]). Über ihren Aufruf wird der Betrieb der LIN-TP-Komponente beendet ([SWS_LinIf_00355]). Die Funktionsdeklaration ist über die Header-Datei LinIf.h verfügbar ([SWS_LinIf_00355]).

Für die Verwendung und Ausführung gelten die folgenden Spezifikationsmerkmale ([SWS_LinIf_00355]):

• Parameter und Rückgabewert: Die Funktion besitzt keine Eingabe-, Ein-/Ausgabe- oder Ausgabeparameter (void) und liefert keinen Rückgabewert (void) zurück ([SWS_LinIf_00355]).
• Dienstidentifikation: Der Service ist unter der Service-ID 0x43 definiert ([SWS_LinIf_00355]).
• Synchronizität: Der Aufruf wird synchron abgearbeitet ([SWS_LinIf_00355]).
• Reentranz: Die Funktion ist nicht reentrant (Non Reentrant) ([SWS_LinIf_00355]). Nebenläufige oder verschachtelte Aufrufe aus verschiedenen Kontexten sind nicht zulässig.

Spezifische Fehlercodes, Rückmeldungen an das Development Error Tracer (DET) oder Sonderbehandlungen bei Fehlern sind für diese Funktion in den Quellen nicht beschrieben ([SWS_LinIf_00355]). Ebenso fehlen Angaben zu verwandten Requirements oder dem exakten Aufrufer; vermutlich erfolgt der Aufruf im Rahmen der sequenziellen Deinitialisierung des Kommunikationsstapels durch ein übergeordnetes BSW-Zustandsmanagement. Frage Q-e25a3c9531527c4f (offen)

Verwendung und Semantik

Die synchrone Funktion LinTp_ChangeParameter dient dazu, einen spezifischen Parameter des Transportprotokolls für eine bestimmte PDU zur Laufzeit anzupassen [SWS_LinIf_00501]. Als Parameter werden die PDU-Kennung (id), der Bezeichner des zu ändernden Transportprotokoll-Parameters (parameter, beispielsweise die Blockgröße) sowie der neue Zielwert (value) übergeben [SWS_LinIf_00501]. Die Deklaration wird über den Header LinIf.h bereitgestellt [SWS_LinIf_00501].

Rückgabewerte und Verhalten im Fehlerfall

Die Funktion signalisiert das Ergebnis der Anfrage unmittelbar über ihren Rückgabewert vom Typ Std_ReturnType [SWS_LinIf_00501]:

• E_OK: Der angeforderte Parameter wurde erfolgreich auf den neuen Wert umgestellt [SWS_LinIf_00501].
• E_NOT_OK: Die Änderung wurde vom LIN-Transportprotokoll abgewiesen [SWS_LinIf_00501]. Dies dürfte typischerweise eintreten, wenn der Parameter ungültig ist oder eine laufende Übertragung die Modifikation verhindert. Frage Q-84aaf28c12dee2e9 (offen)

Nebenläufigkeit und Einschränkungen

Gemäß Spezifikation ist LinTp_ChangeParameter als nicht reentrant (Non Reentrant) eingestuft [SWS_LinIf_00501]. Ein nebenläufiger oder verschachtelter Aufruf für denselben oder parallele Kontexte ist daher unzulässig und muss durch den Aufrufer verhindert werden. Der synchrone Ablauf blockiert den Aufrufer bis zur Entscheidung über die Übernahme des Parameterwerts [SWS_LinIf_00501].

Verwendung und Aufrufkontext

Die synchrone Funktion LinIf_CheckWakeup wird aufgerufen, sobald das Modul EcuM über ein Wakeup-Ereignis auf einem bestimmten LIN-Kanal benachrichtigt wurde [SWS_LinIf_00378]. Der Aufruf erfolgt mit dem Eingangsparameter WakeupSource vom Typ EcuM_WakeupSourceType [SWS_LinIf_00378]. Dieser Parameter spezifiziert das Quellgerät, welches das Weckereignis initiiert hat, wobei es sich um einen LIN-Controller oder einen LIN-Transceiver handeln kann [SWS_LinIf_00378].

Fehlerbehandlung und Rückgabewerte

Als Rückgabewert liefert die Funktion einen Status vom Typ Std_ReturnType [SWS_LinIf_00378]:

• E_OK: Während der Ausführung der Schnittstelle ist kein Fehler aufgetreten [SWS_LinIf_00378].
• E_NOT_OK: Bei der Ausführung der Schnittstelle ist ein Fehler aufgetreten oder es wurde ein ungültiger Wert für WakeupSource übergeben [SWS_LinIf_00378].

Nebenläufigkeit und Integration

Die Schnittstelle ist als reentrant spezifiziert, besitzt die Service-ID 0x60 und wird über die Header-Datei LinIf.h bereitgestellt [SWS_LinIf_00378]. Sie verbindet die Aufweck-Verarbeitung des EcuM direkt mit den Kanälen der LIN-Schnittstelle [SWS_LinIf_00378].

Die synchrone und reentrante Funktion LinIf_EnableBusMirroring aktiviert oder deaktiviert das Bus-Mirroring für einen einzelnen LIN-Kanal [SWS_LinIf_00876]. Sie steht über den Header LinIf.h zur Verfügung und kann entfallen, wenn das Bus-Mirroring über den Konfigurationsparameter LinIfBusMirroringSupport nicht aktiviert ist [SWS_LinIf_00875]. Als Aufrufer dürfte typischerweise das Mirror-Modul fungieren. Frage Q-1703af5207cb7ade (offen)

Über den Parameter Channel wird der betroffene LIN-Kanal übergeben, während MirroringActive den Modus steuert [SWS_LinIf_00876]: Bei Übergabe von TRUE wird das Mirroring aktiviert, bei FALSE deaktiviert [SWS_LinIf_00876]. Als Rückgabewert liefert die Funktion E_OK, wenn der Mirroring-Modus erfolgreich geändert wurde, oder E_NOT_OK, falls ein ungültiger Kanal angegeben wurde oder das Mirroring global deaktiviert ist [SWS_LinIf_00876]. Spezifische DET- oder DEM-Fehlermeldungen sind in der Funktionsdefinition nicht ausgewiesen [SWS_LinIf_00876].

Ist das Bus-Mirroring global über LinIfBusMirroringSupported sowie für den jeweiligen Kanal aktiviert, leitet das LIN-Interface relevante Ereignisse an Mirror_ReportLinFrame weiter:

• Empfangene Frames bei LinIf_RxIndication mit Status LIN_RX_OK und Zeiger auf die Nutzdaten [SWS_LinIf_00838] sowie beim Auslesen des LIN-Treiberstatus für Rx-Slots [SWS_LinIf_00873].
• Gesendete Frames bei LinIf_TxConfirmation mit Status LIN_TX_OK und Zeiger auf die übertragenen Daten [SWS_LinIf_00839] sowie beim Auslesen des LIN-Treiberstatus für Tx-Slots [SWS_LinIf_00874].
• Fehlerbenachrichtigungen bei LinIf_LinErrorIndication für alle Fehlercodes außer LIN_ERR_HEADER mit Fehlerstatus und NULL-Zeiger als Dateninhalt [SWS_LinIf_00869].

Die Funktion LinIf_WakeupConfirmation dient dazu, das erfolgreiche Erkennen eines Weckereignisses an das LIN-Interface zu melden [SWS_LinIf_00715].

Aufruf und Parameter

Der Aufruf erfolgt durch den LIN-Treiber (LIN Driver) oder den LIN-Transceiver-Treiber (LIN Transceiver Driver), nachdem eine erfolgreiche Weckerkennung während Check Wakeup oder nach einem Einschalten über den Bus (power on by bus) stattgefunden hat [SWS_LinIf_00715]. Als Übergabeparameter wird WakeupSource vom Typ EcuM_WakeupSourceType übergeben, welcher das Quellgerät angibt, das das Weckereignis initiiert hat (LIN-Controller oder LIN-Transceiver) [SWS_LinIf_00715].

Ausführungseigenschaften und Schnittstelle

• Semantik: Der Aufruf wird synchron abgewickelt [SWS_LinIf_00715].
• Reentranz: Die Funktion ist als reentrant spezifiziert [SWS_LinIf_00715].
• Rückgabewert: Es gibt keinen Rückgabewert (void) [SWS_LinIf_00715].
• Header: Die Deklaration wird über LinIf.h bereitgestellt (Service-ID: 0x61) [SWS_LinIf_00715].

Die Callback-Funktion LinIf_HeaderIndication wird synchron vom LIN-Treiber aufgerufen, um den Empfang eines LIN-Headers auf einem Slave-Kanal zu melden [SWS_LinIf_91004]. Sie steht ausschließlich zur Verfügung, wenn das Steuergerät über mindestens einen konfigurierten LIN-Slave-Kanal verfügt [SWS_LinIf_91004]. Die Funktion ist reentrant für unterschiedliche Kanäle, darf jedoch für denselben Kanal nicht nebenläufig aufgerufen werden [SWS_LinIf_91004].

Über den Inout-Parameter PduPtr übergibt der Treiber den empfangenen Identifier (PID) sowie den Zeiger auf den SDU-Datenpuffer [SWS_LinIf_91004]. Das LinIf wertet die PID aus und steuert die Reaktion des Slave-Knotens:

• Empfangsrahmen: Gehört die PID zu einem konfigurierten Empfangsrahmen, setzt das LinIf vor der Rückkehr die Prüfsummenart PduPtr->Cs, die Datenlänge PduPtr->Dl und weist PduPtr->Drc den Wert LIN_FRAMERESPONSE_RX zu [SWS_LinIf_00733].
• Sederahmen: Handelt es sich um einen Sederahmen, fordert das LinIf die Nutzdaten via <User_TriggerTransmit> an [SWS_LinIf_00738]. Bei erfolgreicher Bereitstellung (Rückgabewert E_OK oder SRF-Daten durch Node Configuration Handler / Transportprotokoll) werden Prüfsumme und Länge konfiguriert sowie PduPtr->Drc auf LIN_FRAMERESPONSE_TX gesetzt [SWS_LinIf_00739]. Schlägt die Abfrage mit E_NOT_OK fehl, wird PduPtr->Drc auf LIN_FRAMERESPONSE_IGNORE gesetzt [SWS_LinIf_00740].
• Irrelevante Rahmen: Ist der Rahmen für den Slave nicht relevant, setzt das LinIf PduPtr->Drc ebenfalls auf LIN_FRAMERESPONSE_IGNORE [SWS_LinIf_00748].

Zusätzlich lädt jeder Aufruf den laufenden Bus-Idle-Timer neu [SWS_LinIf_00754]. Erfolgt der Aufruf erstmals nach einem erfolgreichen LinIf_Wakeup, wird <User>_WakeupConfirmation(TRUE) ausgelöst [SWS_LinIf_00761]. Beim Empfang eines SRF-Headers startet das LinIf zudem den N_As-Timer für Consecutive Frames (CF) [SWS_LinIf_00800]. Als Rückgabewert signalisiert E_OK die Annahme der Anfrage, während E_NOT_OK Entwicklungs- oder Produktionsfehler anzeigt [SWS_LinIf_91004].

Die Callback-Funktion LinIf_RxIndication wird synchron vom LIN-Treiber aufgerufen, um dem LIN-Interface den erfolgreichen Empfang einer Response inklusive der Empfangsdaten mitzuteilen [SWS_LinIf_91005]. Die Funktion steht ausschließlich auf Steuergeräten mit mindestens einem konfigurierten LIN-Slave-Kanal zur Verfügung [SWS_LinIf_91005].

Hinsichtlich Parametrierung und Nebenläufigkeit gelten folgende Bedingungen:

• Parameter: Übergeben werden die Kanalidentifikation Channel sowie der Zeiger Lin_SduPtr auf einen Shadow-Buffer oder den speicherabgebildeten Empfangspuffer der LIN-Hardware [SWS_LinIf_91005]. Dieser Zeiger ist nur bei tatsächlich empfangener Response gültig [SWS_LinIf_91005].
• Rückgabewert: Die Funktion besitzt keinen Rückgabewert (void) [SWS_LinIf_91005].
• Reentranz: Die Schnittstelle ist reentrant für unterschiedliche LIN-Kanäle, jedoch nicht reentrant für denselben Kanal [SWS_LinIf_91005].

Im Zusammenspiel mit dem Modulverhalten stößt der Aufruf mehrere koordinierende Aktionen an:

• Weiterleitung der empfangenen Nutzdaten und der Nutzdatenlänge an die übergeordnete Schicht über <User_RxIndication> [SWS_LinIf_00734].
• Prüfung auf Sleep-Kommandos: Handelt es sich um einen Master Request Frame (MRF) mit dem NAD 0, erkennt das LIN-Interface ein Go-to-Sleep-Kommando und leitet den Übergang in den Sleep-Modus ein [SWS_LinIf_00750].
• Timer-Steuerung: Bei jedem Aufruf wird der Bus-Idle-Timer neu geladen [SWS_LinIf_00754]. Zudem steuert der Aufruf bei MRF-Frames (FF, CF) den N_Cr-Timer (Start/Neustart bei FF und CF vor dem letzten Frame, Stopp beim letzten CF) [SWS_LinIf_00805].
• Bus-Mirroring: Ist das Mirroring global und für den Kanal aktiviert, meldet das LIN-Interface den Frame mit dem Status LIN_RX_OK via Mirror_ReportLinFrame() weiter [SWS_LinIf_00838].

Die synchrone Callback-Funktion LinIf_TxConfirmation (Service-ID 0x7a, deklariert in LinIf.h) wird vom LIN-Treiber aufgerufen, um die erfolgreiche Übertragung einer Antwort (Response) auf dem angegebenen Kanal zu bestätigen [SWS_LinIf_91006]. Die Funktion besitzt keinen Rückgabewert und ist ausschließlich für Steuergeräte mit mindestens einem konfigurierten LIN-Slave-Kanal vorgesehen [SWS_LinIf_91006].

Beim Eintreffen der Bestätigung führt das LIN-Interface mehrere Folgeverarbeitungen aus:

• Oberschicht-Benachrichtigung: Das Modul leitet das Sendeereignis über die Callback-Funktion <User_TxConfirmation> mit dem Rückgabewert E_OK an die übergeordnete Schicht weiter [SWS_LinIf_00741].
• Fehlerstatus: Falls der erfolgreich gesendete Frame das Fehlersignal response_error beinhaltet, setzt das LIN-Interface dieses Signal zurück [SWS_LinIf_00747].
• Busruheüberwachung: Jeder Aufruf von LinIf_TxConfirmation lädt den laufenden Bus-Idle-Timer des Kanals neu [SWS_LinIf_00754].
• Transportprotokoll (LinTp): Bestätigt der Treiber die Antwort auf einen SRF-Header (Slave Response Frame), stoppt das Interface den Überwachungstimer N_As [SWS_LinIf_00800].
• Bus Mirroring: Ist das Spiegeln global über LinIfBusMirroringSupported konfiguriert und per LinIf_EnableBusMirroring() aktiviert, meldet das Interface den Rahmen mit dem Status LIN_TX_OK und Zeiger auf die Sendedaten an Mirror_ReportLinFrame() [SWS_LinIf_00839].

Bezüglich der Nebenläufigkeit ist LinIf_TxConfirmation für unterschiedliche LIN-Kanäle reentrant ausgelegt, darf jedoch für denselben Kanal nicht reentrant aufgerufen werden [SWS_LinIf_91006].

Verwendung und Aufrufkontext

Die synchrone Funktion LinIf_LinErrorIndication wird vom LIN-Treiber aufgerufen, um aufgetretene Fehler während der Verarbeitung von Header oder Response zu melden [SWS_LinIf_91007]. Sie ist ausschließlich für LIN-Slave-Knoten vorgesehen und setzt voraus, dass das Steuergerät über mindestens einen konfigurierten LIN-Slave-Kanal verfügt [SWS_LinIf_91007]. Als Parameter werden die Kanalidentifikation Channel sowie der aufgetretene Fehlerstatus ErrorStatus vom Typ Lin_SlaveErrorType übergeben [SWS_LinIf_91007].

Fehlerbehandlung und Nebenläufigkeit

Die Funktion ist reentrant für unterschiedliche Kanäle, darf jedoch für denselben Kanal nicht nebenläufig aufgerufen werden [SWS_LinIf_91007]. Beim Aufruf betrachtet das LIN-Interface die Antwort bzw. den übertragenen Frame als verloren und meldet den Laufzeitfehler LINIF_E_RESPONSE an den Default Error Tracer (DET), es sei denn, der gemeldete Fehlerstatus lautet LIN_ERR_HEADER [SWS_LinIf_00735], [SWS_LinIf_00743].

Zusammenspiel und Bus-Überwachung

Unabhängig vom übergebenen Fehlercode lädt das LIN-Interface bei jedem Aufruf von LinIf_LinErrorIndication den laufenden Bus-Idle-Timer neu [SWS_LinIf_00754]. Tritt ein Fehler bei einer SRF-Response nach Empfang eines SRF-Headers auf, bricht das LIN-Interface die Übertragung ab und meldet dies der oberen Schicht über PduR_LinTpTxConfirmation mit dem Ergebnis E_NOT_OK [SWS_LinIf_00796].

Ist Bus-Mirroring über LinIfBusMirroringSupported global aktiv und für den Kanal eingeschaltet, leitet das LIN-Interface Fehler ungleich LIN_ERR_HEADER über Mirror_ReportLinFrame() mit einem NULL-Zeiger für den Dateninhalt weiter [SWS_LinIf_00869]. Hierbei werden die Treiberfehlercodes zuvor in entsprechende Statuswerte des Typs Lin_StatusType übersetzt [SWS_LinIf_00870].

Die konfigurierbare Schnittstelle <User_TriggerTransmit> dient dem synchronen Abruf von SDU-Daten aus einem überlagerten Modul für eine anstehende Übertragung [SWS_LinIf_00528].

Über den Parameter TxPduId wird die angeforderte SDU identifiziert, während PduInfoPtr als Zeiger auf eine Struktur mit dem Zielpuffer (SduDataPtr) und der verfügbaren Puffergröße (SduLength) übergeben wird [SWS_LinIf_00528]. Das aufgerufene überlagerte Modul prüft innerhalb dieser API, ob die bereitstehenden Daten in die gemeldete Puffergröße passen [SWS_LinIf_00528]. Ist ausreichend Platz vorhanden, kopiert das Modul seine Daten nach SduDataPtr, aktualisiert SduLength mit der Anzahl der tatsächlich kopierten Bytes und signalisiert den Erfolg mit dem Rückgabewert E_OK [SWS_LinIf_00528].

Reicht die Puffergröße hingegen nicht aus, werden keine SDU-Daten kopiert und das Modul gibt E_NOT_OK zurück, ohne PduInfoPtr zu verändern [SWS_LinIf_00528]. Bei einem Rückgabewert von E_NOT_OK darf der Aufrufer PduInfoPtr keinesfalls verwenden, da dieser auf ungültige Daten verweisen oder ein NULL-Zeiger sein kann [SWS_LinIf_00528].

Hinsichtlich der Nebenläufigkeit ist die Funktion reentrant für unterschiedliche PDU-IDs, jedoch nicht reentrant für dieselbe PDU-ID [SWS_LinIf_00528].

Die konfigurierbare Callback-Funktion <User_TxConfirmation> wird vom unterlagerten Kommunikationsschnittstellenmodul aufgerufen, um einer oberen Schicht die Übertragung einer PDU oder das Fehlschlagen der Übertragung zu bestätigen [SWS_LinIf_00529]. Der Aufruf erfolgt synchron und liefert keinen Rückgabewert zurück [SWS_LinIf_00529].

Parameter und Semantik

• TxPduId (In): Bezeichnet die Kennung der übertragenen PDU vom Typ PduIdType [SWS_LinIf_00529].
• result (In): Meldet den Erfolgsstatus der Übertragung als Std_ReturnType mit den Werten E_OK bei erfolgreicher PDU-Übertragung oder E_NOT_OK bei fehlgeschlagener Übertragung [SWS_LinIf_00529].

Nebenläufigkeit und Fehlerbehandlung

Hinsichtlich der Reentranz ist die Funktion für unterschiedliche PDU-IDs reentrant ausgelegt, darf jedoch für dieselbe PDU-ID nicht reentrant aufgerufen werden [SWS_LinIf_00529]. Das Modul spezifiziert für diese Schnittstelle keine gesonderten Fehlercodes oder DET- bzw. DEM-Meldungen; das Fehlschlagen einer Übertragung wird stattdessen über den Parameterwert E_NOT_OK angezeigt [SWS_LinIf_00529]. Der tatsächliche Funktionsbezeichner dürfte integrationsspezifisch je nach konfigurierter Benutzerschicht festgelegt werden, da der Dienst als konfigurierbar angegeben ist [SWS_LinIf_00529]. Frage Q-35de931161f26cb8 (offen)

Die Callback-Funktion <User_RxIndication> dient der Signalisierung einer empfangenen PDU von einem unterlagerten Kommunikationsschnittstellenmodul an die übergeordnete Schicht [SWS_LinIf_00530]. Der Aufruf erfolgt mit synchroner Semantik und besitzt keinen Rückgabewert [SWS_LinIf_00530].

Parameter und Schnittstellenspezifikation

Die Funktion übergibt zwei Eingangsparameter an den oberen Layer [SWS_LinIf_00530]:

• RxPduId: Bezeichner der empfangenen PDU vom Typ PduIdType [SWS_LinIf_00530].
• PduInfoPtr: Zeiger auf eine Struktur vom Typ PduInfoType, welche die Länge der Nutzdaten (SduLength), einen Zeiger auf den Puffer mit den Nutzdaten (SduDataPtr) sowie zugehörige Metadaten zur PDU bereitstellt [SWS_LinIf_00530].

Weder Ein-/Ausgangsparameter noch reine Ausgangsparameter sind für diese Schnittstelle vorgesehen [SWS_LinIf_00530].

Nebenläufigkeit und Konfiguration

Bezüglich der Reentranz ist die Funktion für unterschiedliche PDU-IDs reentrant ausgelegt, für identische PDU-IDs hingegen explizit als nicht reentrant spezifiziert [SWS_LinIf_00530]. Aufrufer müssen daher sicherstellen, dass für dieselbe RxPduId keine überlappenden Aufrufe stattfinden. Die Funktion ist als konfigurierbare Schnittstelle deklariert [SWS_LinIf_00530]; der konkrete Funktionsname der oberen Schicht dürfte somit über die Modulkonfiguration festgelegt werden. Frage Q-94175e8cd86775b6 (offen)

Die Schnittstelle <User_ResponseErrorSignalChanged> dient im Modul LinIf als Benachrichtigungsfunktion, um eine Wertänderung des Response-Error-Signals mit dem neuen Signalwert zu melden [SWS_LinIf_00856]. Der Aufruf erfolgt synchron und besitzt die Service-ID 0x74 [SWS_LinIf_00856]. Weder Ein-/Ausgangsparameter noch ein Rückgabewert sind vorgesehen; die Signatur ist mit dem Rückgabetyp void definiert [SWS_LinIf_00856].

Als Übergabeparameter erwartet die Funktion zwei reine Eingangswerte [SWS_LinIf_00856]:

• Channel (Typ NetworkHandleType): Eindeutige Identifikation des betroffenen LIN-Kanals [SWS_LinIf_00856].
• RespErrSigValue (Typ boolean): Aktueller Wert des Response-Error-Signals. Der Parameter ist true, wenn das Signal auf 1 gesetzt ist, andernfalls false [SWS_LinIf_00856].

Hinsichtlich der Nebenläufigkeit und des Aufrufkontextes ist festgelegt, dass die Funktion reentrant für unterschiedliche Kanäle ist, jedoch nicht reentrant für denselben Kanal aufgerufen werden darf [SWS_LinIf_00856]. Eine funktionale Randbedingung besteht darin, dass dieser Benachrichtigungsdienst ausschließlich für LIN-Slave-Knoten anwendbar ist [SWS_LinIf_00856]. Bereitgestellt wird die Deklaration über die Header-Datei LinIf_Externals.h [SWS_LinIf_00856].

Die Callback-Funktion <User_SaveConfigurationRequest> (Service-ID 0x75) benachrichtigt eine übergeordnete Schicht über den Empfang eines „Save Configuration“-Requests und ist in LinIf_Externals.h deklariert [SWS_LinIf_00857]. Diese Schnittstelle ist ausschließlich für LIN-Slave-Knoten anwendbar [SWS_LinIf_00857].

Der Aufruf erfolgt synchron und ist als reentrant spezifiziert [SWS_LinIf_00857]:

• Parameter: Über den Eingangsparameter Channel vom Typ NetworkHandleType wird der betroffene LIN-Kanal übergeben [SWS_LinIf_00857]. Zusätzliche Ein- oder Ausgangsparameter existieren nicht [SWS_LinIf_00857].
• Rückgabewert: Die Funktion liefert einen Wert vom Typ boolean zurück [SWS_LinIf_00857]. Der Rückgabewert TRUE signalisiert, dass eine positive Antwort auf den LIN-Bus gesendet werden soll, während FALSE die Übertragung jeglicher Antwort unterbindet [SWS_LinIf_00857].

Hinsichtlich der Fehlerbehandlung definiert die Spezifikation weder spezifische Fehlercodes noch DET- oder DEM-Meldungen [SWS_LinIf_00857]. Das Verhalten im Fehler- oder Ablehnungsfall wird direkt über den booleschen Rückgabewert gesteuert, indem durch FALSE das Senden einer Antwort verhindert wird [SWS_LinIf_00857]. Da der Aufruf als reentrant klassifiziert ist, dürfte die Funktion für den nebenläufigen Aufruf auf unterschiedlichen Kanälen ausgelegt sein [SWS_LinIf_00857]. Frage Q-84432030c1aff644 (offen)

Der Aufzählungstyp LinTp_Mode ist in der Header-Datei LinIf.h definiert und legt fest, welcher Schedule-Tabellen-Modus während einer Diagnosesitzung durch das LIN-Transport-Protokoll (LIN TP) angefordert werden kann [SWS_LinIf_00629].

Der Wertebereich umfasst drei Enumerations-Literale zur Steuerung des Schedule-Wechsels auf dem LIN-Bus [SWS_LinIf_00629]:

• LINTP_APPLICATIVE_SCHEDULE: Wählt die applikative Schedule-Tabelle für den regulären Botschaftsverkehr aus [SWS_LinIf_00629].
• LINTP_DIAG_REQUEST: Wählt die Master-Request-Schedule-Tabelle zur Übertragung von Diagnoseanforderungen aus [SWS_LinIf_00629].
• LINTP_DIAG_RESPONSE: Wählt die Slave-Response-Schedule-Tabelle zum Empfang von Diagnoseantworten aus [SWS_LinIf_00629].

Hinsichtlich des Zusammenspiels dient der Typ der Umschaltung zwischen Diagnoseübertragungen und regulärer Applikationskommunikation innerhalb des LIN-Interface [SWS_LinIf_00629]. Spezifische Aufrufkontexte, Reentranz-Eigenschaften oder Fehlerbehandlungen (wie DET- oder DEM-Meldungen) sind für diesen reinen Datentyp in den Quellen nicht angegeben; vermutlich wird der Typ als Funktionsparameter bei Steuerungsaufrufen durch das LIN-Transport-Protokoll an das LIN-Interface übergeben. Frage Q-1bf7553401882471 (offen)