Communication Manager (ComM)

Die synchrone Funktion ComM_Init (Service-ID 0x01) dient der grundlegenden Initialisierung des AUTOSAR Communication Managers und startet dessen interne Zustandsmaschinen neu [SWS_ComM_00146]. Als Eingabeparameter übernimmt sie ConfigPtr, welcher als Zeiger auf die Post-Build-Konfigurationsstruktur vom Typ const ComM_ConfigType* übergeben wird [SWS_ComM_00146]. Die Funktion liefert keinen Rückgabewert (Rückgabetyp void) und wird über die Header-Datei ComM.h deklariert [SWS_ComM_00146].

Bezüglich der Nebenläufigkeit ist ComM_Init als nicht reentrant (Non Reentrant) definiert [SWS_ComM_00146]. Ein konkreter Aufrufer wird in den Spezifikationsdaten nicht vorgegeben; vermutlich erfolgt der Aufruf zentral während der Startphase des Steuergeräts im Rahmen der BSW-Initialisierung. Frage Q-7121f73c12407087 (offen)

Im Gesamtsystem besitzt ComM_Init eine zentrale Steuerungs- und Vorbedingungsfunktion für das gesamte Modul: Solange das ComM-Modul nicht initialisiert wurde, dürfen sämtliche Modul- und API-Dienste ihren regulären Betrieb nicht aufnehmen und müssen bei Diensten mit Standard-Rückgabetyp E_NOT_OK zurückmelden [SWS_ComM_00612]. Eine Ausnahme von dieser Sperre gilt ausschließlich für ComM_Init selbst sowie für die Abfragefunktionen ComM_GetVersionInfo und ComM_GetStatus [SWS_ComM_00612].

Verwendung

Die Funktion ComM_DeInit dient gemäß [SWS_ComM_00147] der Deinitialisierung des AUTOSAR Communication Managers (ComM). Der Service ist synchron ausgelegt, besitzt die Service-ID 0x02 und wird über die Header-Datei ComM.h deklariert. Gemäß Signatur void ComM_DeInit(void) nimmt die Funktion keinerlei Eingangs-, Ausgangs- oder Übergabeparameter entgegen und liefert keinen Rückgabewert an den Aufrufer zurück [SWS_ComM_00147].

Fehlerbehandlung

Da die Funktionssignatur void zurückgibt, erfolgt über den Schnittstellenaufruf keine direkte Rückmeldung von Fehler- oder Statuscodes [SWS_ComM_00147]. Spezifische Fehlerreaktionen, wie etwa die Benachrichtigung des Development Error Tracers (DET) oder des Diagnostic Event Managers (DEM), sind in den vorliegenden Spezifikationsdaten nicht enthalten und werden daher nicht ausgewiesen.

Nebenläufigkeit und Systemkontext

Die Schnittstelle ist laut [SWS_ComM_00147] als nicht reentrant (Non Reentrant) spezifiziert. Daraus folgt die zwingende Anforderung an die Systemintegration, parallele oder unterbrechende Aufrufe aus mehreren Tasks oder Kontexten vollständig zu unterbinden. Als Interpretation des Systemablaufs dürfte der Aufruf typischerweise im Zuge des geordneten Steuergeräte-Shutdowns durch ein übergeordnetes Zustandsmanagement (wie den BSW-Manager) erfolgen, sobald die Kommunikationskanäle der BSW heruntergefahren wurden. Frage Q-f3b68dc129993cb7 (offen)

Verwendung und Aufrufkontext

Die synchrone und reentrante Funktion ComM_RequestComMode ([SWS_ComM_00110]) dient dazu, einen Kommunikationsmodus für einen definierten Nutzer (User) anzufordern. Sie ist über ComM.h verfügbar. Als Übergabeparameter für ComMode sind ausschließlich folgende Werte als Nutzeranforderung zulässig:

• COMM_FULL_COMMUNICATION: Anforderung voller Kommunikationsfähigkeit ([SWS_ComM_00110]).
• COMM_NO_COMMUNICATION: Freigabe bzw. Beendigung der Kommunikationsanforderung ([SWS_ComM_00110]).

Die Modi COMM_SILENT_COMMUNICATION (dient der Shutdown-Synchronisation) sowie COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST (interner Wakeup-Trigger für unterlagerte Schichten, z. B. bei OA TC10-fähiger Ethernet-Hardware) sind interne Zustände und dürfen nicht von Nutzern angefordert werden ([SWS_ComM_00110]). Interpretation: Eine Übergabe dieser internen Modi dürfte vermutlich mit E_NOT_OK quittiert werden. Frage Q-973ed1ce1845983e (offen)

Rückgabewerte und Fehlerbehandlung

Die Funktion signalisiert das Ergebnis über definierte Rückgabewerte ([SWS_ComM_00110]):

• E_OK: Der Wechsel in den gewünschten Kommunikationsmodus wurde erfolgreich vollzogen.
• E_NOT_OK: Der Moduswechsel ist fehlgeschlagen.
• COMM_E_MODE_LIMITATION: Der angeforderte Modus kann aufgrund einer aktiven Kommunikationsbegrenzung (Mode Inhibition) nicht gewährt werden. Kommunikationsanforderungen können durch solche Begrenzungen auch wieder freigegeben werden.

Zusammenspiel und Zustandsmaschine

Das Vorliegen oder Fehlen aktiver Anforderungen beeinflusst die Kanal-Zustandsmaschine des ComM. Befindet sich der Kanal im Sub-Zustand COMM_FULL_COM_NETWORK_REQUESTED mit der Konfiguration ComMNmVariant = SLAVE_ACTIVE und liegt kein aktiver Aufruf von ComM_RequestComMode(<user>, COMM_FULL_COMMUNICATION) vor, wechselt die ComM-Zustandsmaschine in den Sub-Zustand COMM_FULL_COM_READY_SLEEP ([SWS_ComM_01017]).

Die synchrone Funktion ComM_UpdatePncToChannelMapping mit der Service-ID 0x62 dient dem Setzen von Einträgen in der PNC-zu-Kanal-Zuordnung des Steuergeräts bzw. des PNC-Gateways [SWS_ComM_91015]. Die Schnittstelle ist über die Header-Datei ComM.h verfügbar und im Release R20-11 mit dem Status Draft gekennzeichnet [SWS_ComM_91015].

Parameter

Dem Funktionsaufruf werden drei Eingangsparameter übergeben [SWS_ComM_91015]:

• MappingTable: Zeiger auf ein zweidimensionales boolean-Array (const boolean*), das die aktuelle PNC-zu-Kanal-Zuordnung des PNC-Gateways enthält, wobei die erste Dimension alle relevanten Kanäle und die zweite Dimension alle relevanten PNCs abdeckt [SWS_ComM_91015].
• channelCnt: Anzahl der physischen Kanäle, die in der MappingTable übergeben werden [SWS_ComM_91015].
• PncCnt: Anzahl der PNCs, die in der MappingTable übergeben werden [SWS_ComM_91015].

Rückgabewerte und Fehlerbehandlung

Die Funktion liefert einen Statuswert vom Typ Std_ReturnType zurück [SWS_ComM_91015]:

• E_OK: Der Zuordnungseintrag wurde erfolgreich gesetzt [SWS_ComM_91015].
• E_NOT_OK: Das Setzen des Zuordnungseintrags ist fehlgeschlagen [SWS_ComM_91015].
• COMM_E_LEARNING_ACTIVE: Der Aufruf kann nicht ausgeführt werden, da die PNC-Lernphase aktiv ist [SWS_ComM_91015].

Nebenläufigkeit und Einschränkungen

Die Schnittstelle ist als nicht reentrant definiert [SWS_ComM_91015]. Aufrufe dürfen daher nicht nebenläufig erfolgen. Eine Aktualisierung ist zudem ausgeschlossen, solange sich das Kommunikationssystem in der aktiven PNC-Lernphase befindet [SWS_ComM_91015].

Die synchrone, nicht reentrante Funktion ComM_ResetPncToChannelMapping dient dem Zurücksetzen dynamischer Einträge des PNC-zu-Kanal-Mappings des Steuergeräts auf die konfigurierten Standardwerte [SWS_ComM_91017]. Sie nimmt keine Übergabeparameter entgegen und liefert einen Statuswert vom Typ Std_ReturnType zurück [SWS_ComM_91017].

Verhalten und Rückgabewerte

Das Verhalten der Funktion hängt vom Zustand der PNC-Lernphase sowie der Konfiguration der Kanäle ab:

• Ist für mindestens einen Kanal ComMDynamicPncToChannelMappingEnabled aktiviert und die PNC-Lernphase nicht aktiv, setzt die Funktion die Zuordnungen auf die Standardwerte der Ursprungskonfiguration (statische Einträge) zurück und liefert E_OK [SWS_ComM_01043].
• Befindet sich das System in einer aktiven PNC-Lernphase und ist für mindestens einen Kanal ComMDynamicPncToChannelMappingEnabled bzw. ComMDynamicPncToChannelMappingSupport auf TRUE gesetzt, wird der Reset verweigert und COMM_E_LEARNING_ACTIVE zurückgegeben [SWS_ComM_01042], [SWS_ComM_01045].
• Schlägt das Zurücksetzen der Zuordnungen auf die Standardwerte fehl, gibt die Funktion E_NOT_OK zurück [SWS_ComM_91017].

Einschränkungen und Aufrufbedingungen

Da ComM_ResetPncToChannelMapping als nicht reentrant (Non Reentrant) spezifiziert ist, dürfen gleichzeitige Aufrufe aus nebenläufigen Kontexten nicht stattfinden [SWS_ComM_91017]. Zudem befindet sich die Schnittstelle im Draft-Status [SWS_ComM_91017].

Verwendung und Semantik

Die asynchrone Funktion ComM_PnLearningRequest stößt das optionale dynamische PNC-zu-Kanal-Mapping (Dynamic PNC-to-channel-mapping) an [SWS_ComM_91019]. Sie veranlasst das Network Management (NM), in den Zustand NM Repeat Message State zurückzukehren [SWS_ComM_91019]. Dabei werden das Partial Network Learning Bit, damit empfangende Knoten antworten, und das Repeat Message Request Bit gesendet, damit empfangende Knoten ebenfalls in den Zustand NM Repeat Message State wechseln [SWS_ComM_91019]. Der Aufruf erfolgt ohne Übergabeparameter über die Schnittstelle in ComM.h mit der Service-ID 0x64 [SWS_ComM_91019].

Rückgabewerte und Fehlerbehandlung

Die Funktion gibt einen Statuswert vom Typ Std_ReturnType zurück [SWS_ComM_91019]:

• E_OK: Der PNC-Lernalgorithmus wurde erfolgreich gestartet [SWS_ComM_91019].
• E_NOT_OK: Der PNC-Lernalgorithmus konnte nicht gestartet werden [SWS_ComM_91019].
• COMM_E_LEARNING_ACTIVE: Der Funktionsaufruf kann nicht ausgeführt werden, da die PNC-Lernphase bereits aktiv ist [SWS_ComM_91019].

Nebenläufigkeit und Konfiguration

Die Funktion ist als nicht reentrant (Non Reentrant) spezifiziert und besitzt den Status draft [SWS_ComM_91019]. Sie steht ausschließlich dann zur Verfügung, wenn der Vorkonfigurationsparameter ComMDynamicPncToChannelMappingSupport auf TRUE gesetzt ist [SWS_ComM_01044].

Die synchrone und nicht-reentrante Funktion ComM_UpdatePncMembership wird von Software-Components (SWCs) genutzt, um die während des PNC-Learnings übertragene PNC-Mitgliedschaft für das optionale dynamische PNC-zu-Kanal-Mapping anzupassen [SWS_ComM_91021]. Sie steht über den Header ComM.h nur dann zur Verfügung, wenn der Konfigurationsparameter ComMDynamicPncToChannelMappingSupport auf TRUE gesetzt ist [SWS_ComM_01047].

Über den Parameter ComM_PncMembership wird ein Byte-Array mit der Länge des PNC-Vektors übergeben, das die aktuelle PNC-Mitgliedschaft des Knotens enthält [SWS_ComM_91021]. Wenn die Funktion auf mindestens einem Kanal aktiviert und die PNC-Lernphase inaktiv ist, wird der Parameter Control ausgewertet [SWS_ComM_01049]:

• Bei Control = 0 wird die aktuelle PNC-Mitgliedschaft mittels einer logischen UND-Verknüpfung mit ComM_PncMembership verrechnet, um entsprechende Bits in der Maske gezielt zurückzusetzen [SWS_ComM_01049].
• Bei Control = 1 wird eine logische ODER-Verknüpfung angewendet, um Bits in der Maske zu setzen [SWS_ComM_01049].

War die Aktualisierung erfolgreich, liefert die Funktion E_OK zurück [SWS_ComM_01049]. Ist hingegen auf mindestens einem Kanal die dynamische Zuordnung konfiguriert und die PNC-Lernphase aktiv, wird die Ausführung verweigert und der spezifische Fehlerwert COMM_E_LEARNING_ACTIVE gemeldet [SWS_ComM_01048]. Tritt während des Aktualisierungsvorgangs ein anderer Fehler auf, wird E_NOT_OK zurückgegeben [SWS_ComM_91021].

Verwendung und Aufrufkontext

Die Funktion ComM_PreventWakeUp dient gemäß [SWS_ComM_00156] dazu, den Inhibitionsstatus COMM_NO_WAKEUP für einen bestimmten Kommunikationskanal zu ändern. Sie wird synchron ausgeführt und ist über die Header-Datei ComM.h verfügbar.

Beim Aufruf werden zwei Eingabeparameter übergeben:

• Channel: Identifiziert den betreffenden Kanal gemäß dem Typ NetworkHandleType ([SWS_ComM_00156]).
• Status: Ein boolescher Wert, mit dem die Weck-Inhibition aktiviert (TRUE) oder deaktiviert (FALSE) wird ([SWS_ComM_00156]).

Rückgabewerte und Fehlerbehandlung

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

• E_OK: Der Weckstatus für den angegebenen Kanal wurde erfolgreich aktualisiert.
• E_NOT_OK: Das Ändern des Weckstatus ist fehlgeschlagen, beispielsweise wenn die Funktionalität über die Ecu-Gruppenklassifizierung (ComMEcuGroupClassification) deaktiviert ist.

Nebenläufigkeit und Einschränkungen

Die Schnittstelle ist als nicht reentrant (Non Reentrant) spezifiziert ([SWS_ComM_00156]). Aufrufer müssen daher sicherstellen, dass parallele Aufrufe für dieselbe Instanz vermieden werden.

Die synchrone Funktion ComM_LimitChannelToNoComMode mit der Service-ID 0x0b dient im Communication Manager dazu, den Inhibitionsstatus für einen einzelnen Kommunikationskanal festzulegen [SWS_ComM_00163]. Sie verhindert oder gestattet den Wechsel des Kanals vom Zustand COMM_NO_COMMUNICATION in einen übergeordneten Kommunikationsmodus [SWS_ComM_00163].

Parameter und Aufrufkontext

Die Schnittstelle ist über die Header-Datei ComM.h deklariert und besitzt weder Ein-/Ausgabe- noch reine Ausgabeparameter [SWS_ComM_00163]. Beim Aufruf werden zwei Eingabeparameter übergeben [SWS_ComM_00163]:

• Channel: Adressiert den jeweiligen Kanal über den Bezeichner vom Typ NetworkHandleType [SWS_ComM_00163].
• Status: Bestimmt als boolean den gewünschten Inhibitionszustand. Die Übergabe von TRUE aktiviert die Begrenzung des Kanals auf COMM_NO_COMMUNICATION, während FALSE diese Limitierung wieder deaktiviert [SWS_ComM_00163].

Rückgabewerte und Fehlerbehandlung

Die Funktion gibt einen Wert des Typs Std_ReturnType an den Aufrufer zurück [SWS_ComM_00163]:

• E_OK: Der Inhibitionsstatus für den adressierten Kanal wurde erfolgreich angepasst [SWS_ComM_00163].
• E_NOT_OK: Die Statusänderung konnte nicht durchgeführt werden, was beispielsweise der Fall ist, wenn die Konfiguration ComMEcuGroupClassification (siehe ECUC_ComM_00563) die Funktionalität deaktiviert [SWS_ComM_00163].

Nebenläufigkeit und Systembezug

Hinsichtlich des Ausführungsverhaltens ist die Funktion synchron (Synchronous) und nicht wiedereintrittsfähig (Non Reentrant) ausgeführt [SWS_ComM_00163]. Für denselben Zweck auf Gesamtsystemebene existiert die verwandte Funktion ComM_LimitECUToNoComMode, welche dieselbe Begrenzung nicht nur kanalbezogen, sondern einheitlich für alle Kanäle des Steuergeräts umsetzt [SWS_ComM_00163].

Verwendung

Die synchrone Funktion ComM_LimitECUToNoComMode (Service-ID 0x0c) ist in ComM.h definiert und dient dazu, den Inhibitionsstatus für das gesamte Steuergerät zu ändern [SWS_ComM_00124]. Sie verhindert oder erlaubt den Wechsel von COMM_NO_COMMUNICATION in einen höheren Kommunikationsmodus für sämtliche Kommunikationskanäle der ECU [SWS_ComM_00124]. Die Steuerung erfolgt über den formalen Parameter Status:

• TRUE: Aktiviert die Begrenzung des Steuergeräts auf den Modus COMM_NO_COMMUNICATION [SWS_ComM_00124].
• FALSE: Deaktiviert die Begrenzung des Steuergeräts auf COMM_NO_COMMUNICATION wieder [SWS_ComM_00124].

Fehlerbehandlung und Rückgabewerte

Die Funktion gibt einen Statuscode vom Typ Std_ReturnType an den Aufrufer zurück [SWS_ComM_00124]:

• E_OK: Der Inhibitionsstatus für das Steuergerät wurde erfolgreich übernommen [SWS_ComM_00124].
• E_NOT_OK: Die Änderung des Inhibitionsstatus ist fehlgeschlagen, beispielsweise wenn der Konfigurationsparameter ComMEcuGroupClassification (siehe ECUC_ComM_00563) die Funktionalität deaktiviert [SWS_ComM_00124].

Ein Aufrufer muss den Rückgabewert auswerten, um zu erkennen, ob die Begrenzung wirksam geschaltet werden konnte oder durch die Modulkonfiguration abgewiesen wurde [SWS_ComM_00124].

Nebenläufigkeit und Zusammenspiel

Die Schnittstelle ist als nicht reentrant (Non Reentrant) deklariert; parallele oder unterbrechende Aufrufe sind daher unzulässig und müssen auf Aufruferseite vermieden werden [SWS_ComM_00124]. Während ComM_LimitChannelToNoComMode dieselbe Steuerungsfunktionalität isoliert für einen einzelnen Kanal bereitstellt, betrifft ComM_LimitECUToNoComMode stets die Gesamtheit aller Kanäle des Steuergeräts [SWS_ComM_00124].

Verwendung und Aufrufkontext

Die synchrone Funktion ComM_ReadInhibitCounter (Service-ID 0x0d) dient dazu, die Anzahl der abgewiesenen Benutzeranfragen nach vollem Kommunikationsbetrieb (COMM_FULL_COMMUNICATION) abzufragen [SWS_ComM_00224]. Die Funktionsdeklaration wird über die Header-Datei ComM.h bereitgestellt [SWS_ComM_00224].

Die Funktion besitzt keine Eingabeparameter. Als einziger Ausgabeparameter dient der Zeiger CounterValue vom Basistyp uint16*, über welchen der Zählerstand für die abgewiesenen Anfragen an den Aufrufer übermittelt wird [SWS_ComM_00224]. Konnte der Zählerstand erfolgreich ermittelt und geschrieben werden, liefert die Funktion E_OK zurück; bei einem Fehlschlag gibt sie E_NOT_OK zurück [SWS_ComM_00224].

Fehlerbehandlung

Spezifische Fehlercodes oder standardisierte Entwicklungsfehler (DET) sind in der Schnittstellenbeschreibung nicht gesondert aufgeführt. Ein Scheitern mit dem Rückgabewert E_NOT_OK [SWS_ComM_00224] dürfte vermutlich durch einen ungültigen Zeigerparameter (Null-Zeiger) oder einen Aufruf vor der Initialisierung des ComM-Moduls bedingt sein (Interpretation). Frage Q-5779d898381d9894 (offen)

Nebenläufigkeit und Einschränkungen

Die Schnittstelle ist explizit als nicht-reentrant (Non Reentrant) spezifiziert [SWS_ComM_00224]. Aufrufer müssen daher auf Systemebene sicherstellen, dass keine konkurrierenden oder unterbrechenden Aufrufe über unterschiedliche Tasks oder Interrupt-Service-Routinen erfolgen, um Inkonsistenzen beim Auslesen des Zählers zu vermeiden.

Verwendung und Funktionsweise

Die synchrone Schnittstelle ComM_ResetInhibitCounter dient dazu, den internen Zähler für abgewiesene oder unterbundene Vollkommunikations-Anfragen (Inhibited COMM_FULL_COMMUNICATION request Counter) im Communication Manager zurückzusetzen [SWS_ComM_00108]. Der Aufruf wird über den Header ComM.h bereitgestellt, besitzt die Service-ID 0x0e und erfordert keine Übergabeparameter [SWS_ComM_00108]. Bei erfolgreicher Durchführung liefert die Funktion den Rückgabewert E_OK vom Typ Std_ReturnType [SWS_ComM_00108].

Fehlerbehandlung und Randbedingungen

Tritt beim Zurücksetzen des Zählers ein Fehler auf, signalisiert der Dienst dies durch den Rückgabewert E_NOT_OK [SWS_ComM_00108]. Konkrete Entwicklungsfehler (DET) oder Fehlerszenarien sind im vorliegenden Spezifikationsauszug nicht aufgeführt; vermutlich schlägt die Ausführung fehl und liefert E_NOT_OK, wenn das Modul noch nicht initialisiert wurde. Frage Q-31d1ba95e419fa8e (offen)

Nebenläufigkeit

Die Funktion ist als nicht reentrant (Non Reentrant) deklariert [SWS_ComM_00108]. Anwender müssen deshalb durch geeignete Synchronisation sicherstellen, dass keine parallelen Aufrufe aus mehreren Threads, Tasks oder Interrupt-Dienstroutinen erfolgen, um Inkonsistenzen am Zähler zu vermeiden.

Die Funktion ComM_Nm_NetworkStartIndication dient als Benachrichtigungsschnittstelle der Netzwerkverwaltung an den Communication Manager. Gemäß [SWS_ComM_00383] zeigt sie an, dass während des Zustands Bus Sleep Mode eine NM-Botschaft empfangen wurde, was signalisiert, dass bestimmte Knoten im Netzwerk bereits in den Network Mode gewechselt sind.

• Aufruf und Parameter: Die Schnittstelle wird über den Header ComM_Nm.h deklariert und nimmt als Eingabeparameter den betroffenen Kommunikationskanal Channel vom Typ NetworkHandleType entgegen [SWS_ComM_00383].
• Synchronizität und Rückgabe: Der Aufruf besitzt keinen Rückgabewert (void) und folgt einer asynchronen Ausführungssemantik [SWS_ComM_00383].
• Nebenläufigkeit: Die Funktion ist mit der Service-ID 0x15 versehen und als reentrant (Reentrant) spezifiziert [SWS_ComM_00383].

Spezifische Fehlercodes, DET- oder DEM-Meldungen sowie gesonderte Fehlerreaktionen sind für diese Schnittstelle in der Spezifikation nicht ausgewiesen [SWS_ComM_00383]. Interpretation: Die Indikation dürfte intern dazu bestimmt sein, den Übergang aus dem Ruhezustand zur aktiven Netzwerkkommunikation für den angegebenen Kanal einzuleiten. Frage Q-97a02db4ab6a3af8 (offen)

Die Funktion ComM_Nm_NetworkMode fungiert im AUTOSAR-Kommunikationsmanager (ComM) als Benachrichtigungs-Callback, mit dem das Netzwerkmanagement (Nm) signalisiert, dass der Netzwerkmodus (Network Mode) erfolgreich eingenommen wurde [SWS_ComM_00390].

Aufruf und Parameter

Die Schnittstelle ist über die Header-Datei ComM_Nm.h verfügbar und besitzt die Service-ID 0x18 [SWS_ComM_00390]. Beim Aufruf wird über den einzigen Eingabeparameter Channel vom Typ NetworkHandleType der betroffene Kommunikationskanal übergeben [SWS_ComM_00390]. Die Funktion liefert keinen Rückgabewert zurück (Rückgabetyp void) und verfügt über keine Ausgabeparameter [SWS_ComM_00390].

Nebenläufigkeit und Semantik

Das Ausführungsverhalten von ComM_Nm_NetworkMode ist als asynchron (Asynchronous) deklariert [SWS_ComM_00390]. In Bezug auf die Nebenläufigkeit ist die Funktion reentrant (Reentrant) spezifiziert, sodass sie für parallele Kanalereignisse wiedereintrittsfähig aufgerufen werden kann [SWS_ComM_00390].

Fehlerbehandlung

Da die Signatur keinen Rückgabewert vorsieht, werden keine Fehlercodes direkt an den Aufrufer übermittelt [SWS_ComM_00390].

Die Funktion ComM_Nm_PrepareBusSleepMode dient als Benachrichtigungsschnittstelle des Communication Managers (ComM). Sie informiert den ComM darüber, dass das Netzwerkmanagement für den angegebenen Kommunikationskanal in den Zustand „Prepare Bus - Sleep Mode“ gewechselt ist [SWS_ComM_00391].

Verwendung und Signatur

Die Schnittstelle ist über die Header-Datei ComM_Nm.h verfügbar und besitzt die Service-ID 0x19 [SWS_ComM_00391]. Die Ausführung erfolgt asynchron [SWS_ComM_00391]. Die Funktionssignatur umfasst folgende Parameter:

• Channel (In, NetworkHandleType): Identifiziert den betroffenen Netzwerkkanal, dessen Netzwerkmanagement den Prepare-Bus-Sleep-Modus eingenommen hat [SWS_ComM_00391].
• Rückgabewert: void; es werden keine Status- oder Fehlerwerte zurückgeliefert und keine Ein-/Ausgabeparameter geführt [SWS_ComM_00391].

Nebenläufigkeit und Einschränkungen

Hinsichtlich der Nebenläufigkeit ist ComM_Nm_PrepareBusSleepMode als reentrant spezifiziert, jedoch mit der verbindlichen Einschränkung, dass dies nicht für denselben NM-Kanal gilt (Reentrant (but not for the same NM - Channel)) [SWS_ComM_00391]. Aufrufe für unterschiedliche Kanäle dürfen daher parallel erfolgen, während gleichzeitige Aufrufe für denselben Kanal auszuschließen sind.

Aufrufkontext und Fehlerbehandlung

Interpretation: Der Aufrufkontext dürfte im generischen oder busspezifischen Network Management liegen, welches das Erreichen dieses Zustands an den ComM meldet. Frage Q-41524322db480310 (offen) Spezifische Fehlercodes, DET- oder DEM-Meldungen sind für diese Schnittstelle in der Spezifikation nicht definiert [SWS_ComM_00391].

Verwendung

Die Callback-Funktion ComM_Nm_BusSleepMode dient als Benachrichtigung an das Modul ComM darüber, dass das Netzwerkmanagement in den Bus-Sleep-Modus gewechselt ist [SWS_ComM_00392]. Durch diesen Aufruf soll die Funktion den Wechsel der zugehörigen Hardware sowie des Transceivers in den Bus-Sleep-Modus durchführen [SWS_ComM_00392].

Schnittstelle und Parameter

Die Funktion wird über die Header-Datei ComM_Nm.h bereitgestellt und führt die Service-ID 0x1a [SWS_ComM_00392]. Der Aufruf erfolgt über die Signatur void ComM_Nm_BusSleepMode (NetworkHandleType Channel) mit folgenden Parametereigenschaften [SWS_ComM_00392]:

• Channel: Eingangsparameter vom Typ NetworkHandleType, der den betroffenen Kommunikationskanal identifiziert [SWS_ComM_00392].
• Weder Ein-/Ausgabeparameter noch Ausgabeparameter sind für diese Funktion vorgesehen [SWS_ComM_00392].
• Es ist kein Rückgabewert definiert (void) [SWS_ComM_00392].

Nebenläufigkeit und Einschränkungen

Hinsichtlich des Ausführungsverhaltens und möglicher Einschränkungen spezifiziert die Anforderung folgende Rahmenbedingungen [SWS_ComM_00392]:

• Asynchrone Semantik: Der Aufruf ist als asynchron (Asynchronous) klassifiziert [SWS_ComM_00392].
• Reentranz: Die Funktion ist als reentrant (Reentrant) definiert [SWS_ComM_00392].

Die Callback-Funktion ComM_Nm_RestartIndication mit der Service-ID 0x1b wird vom NM-Interface aufgerufen und ist über die Header-Datei ComM_Nm.h deklariert [SWS_ComM_00792]. Sie dient dazu, den Communication Manager über den Wiederanlauf des Netzwerkmanagements während eines laufenden Abschaltvorgangs koordinierter Busse in Kenntnis zu setzen [SWS_ComM_00792]. Der einzige Eingabeparameter Channel vom Typ NetworkHandleType benennt den betroffenen Kanal; die Operation liefert keinen Rückgabewert zurück [SWS_ComM_00792].

Die Schnittstelle ist als asynchron und reentrant spezifiziert [SWS_ComM_00792]. Ihr Aufruf durch das NM-Interface erfolgt, wenn drei Bedingungen gleichzeitig vorliegen:

• Das NM-Interface hat mit dem Herunterfahren der koordinierten Busse bereits begonnen [SWS_ComM_00792].
• Es haben noch nicht alle dieser koordinierten Busse den Bus-Sleep-Zustand gemeldet [SWS_ComM_00792].
• Auf mindestens einem der koordinierten Busse wird das Netzwerkmanagement neu gestartet [SWS_ComM_00792].

Sind diese Voraussetzungen erfüllt, ruft das NM-Interface die Funktion spezifisch mit dem Handle derjenigen Kanäle auf, die den Bus-Sleep-Zustand bereits signalisiert hatten [SWS_ComM_00792].

Spezifische Fehlercodes, Fehlerreaktionen oder Meldungen an das Entwicklungstest- oder Fehlerspeicher-Modul (DET/DEM) sind im Spezifikationsauszug nicht vorgesehen [SWS_ComM_00792]. Interpretation: Die Funktion dürfte im ComM dafür vorgesehen sein, den internen Zustand bereits schlafender Kanäle wieder an die reaktivierte Buskoordinierung anzugleichen. Frage Q-fc8310cb445f2d3d (offen)

Verwendung

Die Funktion ComM_Nm_RepeatMessageLeftIndication dient als Benachrichtigungsschnittstelle, die dem ComM signalisiert, dass der Zustand aller Bus-NM-Module (<Bus Nm>) den Zustand Repeat Message verlassen hat [SWS_ComM_91024]. Im Rahmen des optionalen Funktionsmerkmals zur dynamischen Zuordnung von Partial Network Clusters zu Kanälen (Dynamic PNC-to-channel-mapping) zeigt dieser Aufruf an, dass die Lernphase endet [SWS_ComM_91024].

Die Schnittstelle wird über den Header ComM_Nm.h deklariert und besitzt keinen Rückgabewert (void) [SWS_ComM_91024]. Als Übergabeparameter wird der betroffene Kommunikationskanal übermittelt:

• Channel (In, NetworkHandleType): Identifikation des Kanals, für den das Verlassen des Zustands gemeldet wird [SWS_ComM_91024].

Zusammenspiel und funktionale Wirkung

Das Verhalten der Indikation steuert die PNC-Lernphase: Sofern der Konfigurationsparameter ComMDynamicPncToChannelMappingEnabled auf TRUE gesetzt ist und ComM_Nm_RepeatMessageLeftIndication aufgerufen wird, setzt der ComM die PNC-Lernphase (PNC Learning Phase) für den entsprechenden Kanal auf inaktiv [SWS_ComM_01029] [SWS_ComM_01046].

Nebenläufigkeit und Einschränkungen

Die Schnittstelle ist als reentrant spezifiziert und weist eine asynchrone Ausführungssemantik auf [SWS_ComM_91024]. In der vorliegenden Spezifikation ist das Element zudem mit dem Entwicklungsstatus draft gekennzeichnet [SWS_ComM_91024].

Die Funktion ComM_Nm_PncLearningBitIndication dient als Benachrichtigungsschnittstelle für das Modul ComM, um den Empfang einer NM-Nachricht mit gesetztem PNC-Learning-Bit anzuzeigen [SWS_ComM_91026]. Die Schnittstelle besitzt die Service-ID 0x69, wird über die Header-Datei ComM_Nm.h bereitgestellt und ist in der Spezifikation mit dem Status „draft“ gekennzeichnet [SWS_ComM_91026].

Hinsichtlich Verwendung und Signatur gelten die folgenden Festlegungen:

• Parameter: Als Eingabeparameter wird Channel vom Typ NetworkHandleType übergeben, der den betroffenen Kommunikationskanal identifiziert [SWS_ComM_91026]. Es gibt weder Ein-/Ausgabeparameter noch Ausgabeparameter, und der Rückgabetyp ist void [SWS_ComM_91026].
• Nebenläufigkeit: Der Aufruf ist als asynchron und reentrant spezifiziert [SWS_ComM_91026]. Dem Bezeichner und dem Header nach dürfte der Aufruf typischerweise durch das unterlagerte NM-Modul erfolgen, sobald eine entsprechende NM-Botschaft empfangen wurde. Frage Q-31b0ce30b88c71b6 (offen)
• Fehlerbehandlung: Im Spezifikationsumfang sind für diesen Service weder Rückgabewerte noch spezifische Fehlercodes oder Meldungen an DET bzw. DEM dokumentiert.

Im Zusammenspiel mit dem dynamischen PNC-Mapping steuert die Funktion die Aktivierung der Lernphase: Wird ComM_Nm_PncLearningBitIndication auf einem Kanal aufgerufen, für den der Konfigurationsparameter ComMDynamicPncToChannelMappingEnabled auf TRUE gesetzt ist, muss ComM die PNC-Lernphase (PNC Learning Phase) für diesen Kanal auf aktiv setzen [SWS_ComM_01026]. Denselben Zustand einer aktiven Lernphase auf dem betreffenden Kanal löst ComM laut Spezifikation auch dann aus, wenn das Modul selbst Nm_PnLearningRequest aufruft [SWS_ComM_01026].

Die synchrone und reentrante Funktion ComM_Nm_ForwardSynchronizedPncShutdown (Service-ID 0x6b) wird über den Header ComM_Nm.h deklariert und dient der koordinierten Weiterleitung eines synchronisierten PNC-Shutdowns [SWS_ComM_91003].

Verwendung und Aufrufkontext: Sie wird aufgerufen, wenn ein Steuergerät in der Rolle eines Zwischen-PNC-Koordinators (intermediate PNC coordinator) eine PN-Shutdown-Nachricht über ein Bus-spezifisches NM empfängt [SWS_ComM_91003]. Als einziger Eingabeparameter wird der betroffene Kommunikationskanal (Channel vom Typ NetworkHandleType) übergeben. Ein Rückgabewert ist nicht definiert (void) [SWS_ComM_91003].

Zusammenspiel und Ablauf: Nach der Indikation gibt das ComM unverzüglich die betroffenen PNC-Zustandsmaschinen frei. Zudem leitet es die PN-Informationen unmittelbar an die betroffenen ComM-Kanäle sowie die korrespondierenden NM-Kanäle weiter [SWS_ComM_91003]. Dadurch wird ein weitgehend synchroner PNC-Shutdown über die hierarchische PN-Topologie vom übergeordneten Top-Level-Koordinator bis zu den untergeordneten PNC-Knoten sichergestellt [SWS_ComM_91003].

Fehlerbehandlung und Randbedingungen: Da die Schnittstelle keinen Rückgabewert aufweist und keine spezifischen Fehlercodes dokumentiert sind, dürfte eine Fehlerbehandlung intern oder über das DET erfolgen. Frage Q-618a8c1da055cdf5 (offen) Das Element ist in Release R20-11 als Draft eingestuft [SWS_ComM_91003].

Verwendung und Aufrufkontext

Die synchrone Schnittstelle ComM_DCM_ActiveDiagnostic dient dem Diagnostic Communication Manager (DCM) zur Benachrichtigung des Communication Managers (ComM) über aktive Diagnoseaktivitäten auf einem bestimmten Kommunikationskanal [SWS_ComM_00873]. Die Funktion ist in der Header-Datei ComM_Dcm.h definiert und mit der Service-ID 0x1f ausgewiesen [SWS_ComM_00873].

Als einziger Aufrufparameter fungiert der Eingangsparameter Channel vom Datentyp NetworkHandleType, der den betroffenen Kanal für die anstehende Diagnosekommunikation eindeutig identifiziert [SWS_ComM_00873]. Die Schnittstelle besitzt keinen Rückgabewert (Rückgabetyp void), und es existieren weder Ein-/Ausgangs- noch Ausgangsparameter [SWS_ComM_00873].

Nebenläufigkeit und Einschränkungen

Bezüglich der Nebenläufigkeit ist das Serviceelement als reentrant spezifiziert [SWS_ComM_00873]. Dies erlaubt parallele synchrone Aufrufe der Funktion aus unterschiedlichen Ausführungskontexten heraus, etwa wenn der DCM mehrere Netzwerkkanäle zeitgleich verwalten oder bedienen muss.

Fehlerbehandlung und Zusammenspiel

Für diesen Aufruf sind keine gesonderten Fehlercodes oder Meldungen an das Entwicklungsfehler-Management (DET) sowie das Diagnose-Fehlerspeicher-Management (DEM) festgelegt [SWS_ComM_00873]. Das Zusammenspiel beschränkt sich auf den Signalaustausch zwischen DCM und ComM; Interpretation: Der Aufruf dürfte im ComM dazu genutzt werden, den entsprechenden Kanal für die Dauer der Diagnoseaktivität im aktiven Kommunikationszustand zu halten [SWS_ComM_00873]. Frage Q-bfd91da2e435fbb6 (offen)

Verwendung

Die synchrone Funktion ComM_DCM_InactiveDiagnostic dient dem Diagnostic Communication Manager (DCM) dazu, dem Communication Manager (ComM) anzuzeigen, dass die Diagnosekommunikation auf einem bestimmten Kanal inaktiv ist und nicht länger benötigt wird [SWS_ComM_00874]. Die Deklaration dieser Schnittstelle wird über die Header-Datei ComM_Dcm.h mit der Service-ID 0x20 bereitgestellt [SWS_ComM_00874].

Als Eingabeparameter wird Channel vom Typ NetworkHandleType übergeben, der den betreffenden Kommunikationskanal identifiziert [SWS_ComM_00874]. Die Funktion besitzt weder Ein-/Ausgabeparameter noch Ausgabeparameter und gibt keinen Wert zurück (void) [SWS_ComM_00874].

Nebenläufigkeit und Fehlerbehandlung

Die Schnittstelle ist als reentrant spezifiziert [SWS_ComM_00874], sodass gleichzeitige Aufrufe – etwa für verschiedene Kommunikationskanäle – zulässig sind. Spezifische Fehlercodes, DET-Fehlermeldungen oder DEM-Ereignisse sind für diese Funktion im Payload nicht definiert [SWS_ComM_00874]. Das ComM-Modul dürfte die Inaktivitätsmeldung intern dazu nutzen, bestehende Diagnoseanforderungen für den Kanal zurückzunehmen und den Kanalstatus entsprechend anzupassen. Frage Q-148d39d8c17e936c (offen)

Die Funktion ComM_EcuM_WakeUpIndication dient der Benachrichtigung des Communication Managers (ComM) über ein aufgetretenes Wake-up-Ereignis auf dem jeweils betroffenen Kommunikationskanal [SWS_ComM_00275]. Der Aufruf dürfte typischerweise durch den ECU State Manager (EcuM) erfolgen, sobald dieser ein entsprechendes Wake-up auf einem Kanal registriert hat. Frage Q-5f8c43b9df10dc8e (offen)

Verwendung und Aufrufkontext

Die Schnittstelle ist synchron definiert und besitzt die Service-ID 0x2a [SWS_ComM_00275]. Über den Eingabeparameter Channel vom Typ NetworkHandleType wird der Bezeichner des Kommunikationskanals übergeben, auf dem das Wake-up erkannt wurde [SWS_ComM_00275]. Die Funktion besitzt keinen Rückgabewert (void) und wird über die Header-Datei ComM_EcuM.h deklariert [SWS_ComM_00275].

Nebenläufigkeit und Einschränkungen

Gemäß Spezifikation ist ComM_EcuM_WakeUpIndication als reentrant eingestuft [SWS_ComM_00275]. Damit darf die Funktion parallel für unterschiedliche Kanäle oder aus nebenläufigen Kontexten heraus aufgerufen werden. Spezifische Fehlercodes, Rückgabewerte oder DET-/DEM-Meldungen sind in der Elementdefinition nicht ausgewiesen [SWS_ComM_00275].

Verwendung und Aufrufkontext

Die synchrone Funktion ComM_EcuM_PNCWakeUpIndication dient zur Benachrichtigung des Communication Managers über ein Wake-up auf einem Partial Network Cluster (PNC) [SWS_ComM_91001]. Sie wird über den Header ComM_EcuM.h deklariert und erwartet als Eingabeparameter PNCid die Kennung des betroffenen Clusters; Rückgabewerte existieren nicht [SWS_ComM_91001]. Interpretation: Der Aufruf erfolgt typischerweise durch den ECU State Manager (EcuM) bei Erkennung eines entsprechenden PNC-Ereignisses. Frage Q-fee4a70f73cde8ea (offen)

Nebenläufigkeit und Zustandsübergänge

Die Schnittstelle ist als reentrant spezifiziert [SWS_ComM_91001]. Ihr Aufruf bewirkt gezielte Zustandswechsel innerhalb der PNC- und Kanal-Zustandsmaschinen des ComM:

• Befindet sich der referenzierte Cluster im PNC-Hauptzustand PNC_NO_COMMUNICATION, wird dieser verlassen und in den PNC-Unterzustand PNC_PREPARE_SLEEP gewechselt [SWS_ComM_00964].
• Erfolgt der Aufruf im Unterzustand COMM_NO_COM_NO_PENDING_REQUEST bei aktivierter PNC-Unterstützung (ComMPncSupport=TRUE) und deaktiviertem synchronen Wake-up (ComMSynchronousWakeUp=FALSE), überführt das Modul diejenigen ComM-Kanal-Zustandsmaschinen in den Unterzustand COMM_NO_COM_REQUEST_PENDING, die vom angegebenen PNC referenziert werden [SWS_ComM_01014].
• Ist hingegen ComMSynchronousWakeUp=TRUE bei aktivem ComMPncSupport konfiguriert, schaltet der Aufruf im Unterzustand COMM_NO_COM_NO_PENDING_REQUEST ausnahmslos alle ComM-Kanal-Zustandsmaschinen in den Unterzustand COMM_NO_COM_REQUEST_PENDING [SWS_ComM_01015].

Über die Funktion ComM_CommunicationAllowed ([SWS_ComM_00871]) wird dem Modul ComM durch EcuM oder BswM angezeigt, ob die Kommunikation für einen bestimmten Kanal freigegeben ist.

Verwendung und Aufrufkontext

Die Schnittstelle wird vom Modul EcuM oder BswM aufgerufen; wird EcuM Flex eingesetzt, übernimmt BswM diese Aufgabe ([SWS_ComM_00871]). Die Funktion ist über den Header ComM_BswM.h deklariert und besitzt die Service-ID 0x35 ([SWS_ComM_00871]).

Die Funktion besitzt keinen Rückgabewert (void) und erwartet folgende Übergabeparameter ([SWS_ComM_00871]):

• Channel (Typ NetworkHandleType): Bezeichnet den betroffenen Kommunikationskanal ([SWS_ComM_00871]).
• Allowed (Typ boolean): Übergibt den Freigabestatus mit TRUE für erlaubte Kommunikation bzw. FALSE für nicht erlaubte Kommunikation ([SWS_ComM_00871]).

Nebenläufigkeit und Einschränkungen

Die Funktion arbeitet laut Spezifikation asynchron (Asynchronous) und ist als nicht reentrant (Non Reentrant) eingestuft ([SWS_ComM_00871]). Aufgrund der Nicht-Reentranz dürfte der Aufrufer gewährleisten müssen, dass keine parallelen oder unterbrechenden Aufrufe für die Schnittstelle erfolgen. Frage Q-e6688e3286d9ed60 (offen)

Verwendung und Signatur

Die Schnittstelle ComM_BusSM_ModeIndication dient der Indikation des tatsächlichen Bus-Modus durch den zuständigen Bus State Manager an das Modul ComM [SWS_ComM_00675]. Die C-Funktion ist über den Header ComM.h verfügbar und wird unter der Service-ID 0x33 geführt [SWS_ComM_00675]. Ihre Syntax lautet void ComM_BusSM_ModeIndication (NetworkHandleType Channel, ComM_ModeType ComMode) [SWS_ComM_00675].

Die Funktion nimmt zwei Eingabeparameter entgegen:

• Channel: Der betroffene Kommunikationskanal vom Typ NetworkHandleType [SWS_ComM_00675].
• ComMode: Der tatsächliche Modus des Busses vom Typ ComM_ModeType [SWS_ComM_00675].

Die Schnittstelle besitzt keinen Rückgabewert (void) und definiert weder Ein-/Ausgabeparameter noch reine Rückgabeparameter [SWS_ComM_00675].

Nebenläufigkeit und Synchronisation

Für das Laufzeitverhalten ist festgelegt, dass der Aufruf asynchron (Asynchronous) erfolgt und die Funktion reentrant (Reentrant) ausgeführt werden kann [SWS_ComM_00675].

Zusammenspiel im Gesamtsystem

Das Modul ComM leitet den über diesen Aufruf gemeldeten Zustand an die Benutzer weiter [SWS_ComM_00675]. Diese Propagierung des Bus-Zustands erfolgt über die Schnittstellen der RTE und des BswM [SWS_ComM_00675].

Verwendung

Die synchrone Service-Funktion ComM_BusSM_BusSleepMode dient dem zuständigen Bus State Manager (BusSM) als Benachrichtigung an den Communication Manager (ComM), dass der tatsächliche Busmodus eines Kommunikationskanals in den Zustand Bus-Sleep gewechselt ist [SWS_ComM_91000]. Die Identifikation des betroffenen Kanals erfolgt über den Eingangsparameter Channel vom Typ NetworkHandleType [SWS_ComM_91000]. Die Funktion deklariert weder Ausgabeparameter noch einen Rückgabewert (void) [SWS_ComM_91000].

Konfigurationsabhängige Gültigkeit

Der Aufruf ist nicht universell zulässig, sondern explizit auf ComM-Kanäle beschränkt, deren Parameter ComMNmVariant auf SLAVE_ACTIVE oder SLAVE_PASSIVE gesetzt ist [SWS_ComM_91000]. Die Spezifikation nennt hierfür zwei typische Einsatzszenarien:

• LIN-Slaves mit der Konfiguration ComMNmVariant = SLAVE_ACTIVE [SWS_ComM_91000].
• Ethernet-Kanäle mit Hardware nach OPEN Alliance TC10, die als passive Kommunikations-Slaves betrieben werden, wobei ComMNmVariant = SLAVE_PASSIVE und der Parameter EthTrcvActAsSlavePassiveEnabled auf TRUE festgelegt ist [SWS_ComM_91000].

Nebenläufigkeit und Integration

Die Schnittstelle besitzt die Service-ID 0x34, ist über die Header-Datei ComM.h deklariert und als reentrant eingestuft [SWS_ComM_91000]. Spezifische Fehlercodes oder ein gesondertes Verhalten im Fehlerfall sind in der Funktionsdefinition nicht ausgewiesen [SWS_ComM_91000].

Der Enumerationstyp ComM_InitStatusType dient der Repräsentation des Initialisierungsstatus des Moduls ComM (COM Manager) und ist über die Header-Datei ComM.h verfügbar [SWS_ComM_00668].

Der Wertebereich umfasst genau zwei Zustände zur Unterscheidung der Betriebsbereitschaft [SWS_ComM_00668]:

• COMM_UNINIT (codiert mit dem Wert 0x00 bzw. 0): Zeigt an, dass der COM Manager nicht initialisiert oder nicht verwendbar ist. Dieser Zustand ist zwingend der Standardwert direkt nach einem Reset [SWS_ComM_00668].
• COMM_INIT (codiert mit dem Wert 0x01): Gibt an, dass der COM Manager ordnungsgemäß initialisiert wurde und einsatzbereit ist [SWS_ComM_00668].

Bezüglich der zeitlichen Reihenfolge und der Modulnutzung markiert dieser Status die grundsätzliche Verwendbarkeit des COM Managers [SWS_ComM_00668]. Interpretation: Aufrufer oder interne Modulroutinen dürften diesen Status auswerten, um sicherzustellen, dass keine Kommunikationsanfragen im Zustand COMM_UNINIT verarbeitet werden, da der COM Manager in diesem Zustand explizit als nicht nutzbar spezifiziert ist [SWS_ComM_00668]. Frage Q-2c4da2e5c40a0f4b (offen) Erst nach dem erfolgreichen Wechsel in COMM_INIT steht das Modul für übergeordnete Interaktionen zur Verfügung.

Der Enumerationstyp ComM_PncModeType definiert den aktuellen Betriebszustand eines Partial Network Clusters (PNC) im Communication Manager [SWS_ComM_00673]. Der Typ wird über die Header-Datei ComM.h bereitgestellt und umfasst fünf diskrete Zustände [SWS_ComM_00673]:

• COMM_PNC_REQUESTED (0x00): Der PNC wird durch einen lokalen ComM-Benutzer angefordert.
• COMM_PNC_READY_SLEEP (0x01): Der PNC wird durch einen entfernten ComM-Benutzer angefordert.
• COMM_PNC_PREPARE_SLEEP (0x02): Der PNC ist aktiv, jedoch ohne Überwachung von Fristen (Deadline Monitoring).
• COMM_PNC_NO_COMMUNICATION (0x03): Für den PNC findet keine Kommunikation statt.
• COMM_PNC_REQUESTED_WITH_WAKEUP_REQUEST (0x04): Lokale PNC-Anforderung mit zusätzlicher Aufforderung zur Hardware-Weckung an den BswM.

Im Zusammenspiel mit dem BswM dient der Modus COMM_PNC_REQUESTED_WITH_WAKEUP_REQUEST dazu, zu signalisieren, dass eine aktive Anforderung zusätzlich das Wecken der Kommunikationshardware auslösen soll [SWS_ComM_00673]. Dies setzt voraus, dass die Funktion unterstützt und konfiguriert ist, beispielsweise beim Port-Switching von Ethernet-Switches nach OA TC10 [SWS_ComM_00673]. Als Einschränkung ist zu beachten, dass dieser Modus im Release R20-11 mit dem Status draft versehen ist [SWS_ComM_00673].

Da es sich um eine reine Typdefinition handelt, existieren für ComM_PncModeType keine eigenen Fehlerbehandlungsroutinen oder Reentranzvorgaben.

Interpretation: Da der Typ in ComM.h deklariert ist und der BswM als Empfänger der Modusinformationen adressiert wird, dürfte der Datentyp modulübergreifend als Schnittstellenparameter für PNC-Statusmeldungen genutzt werden. Frage Q-88ad945ffcf90e9e (offen)

Verwendung und Definition

Der Typ ComM_StateType repräsentiert die Zustände und Sub-Zustände der internen Zustandsmaschine des Communication Managers (ComM) in der AUTOSAR-Classic-Plattform [SWS_ComM_00674]. Er ist als eigenständiger Typ auf Basis des Standardtyps uint8 definiert und wird über die Header-Datei ComM.h für Software-Komponenten und BSW-Module bereitgestellt [SWS_ComM_00674].

Wertebereich und Sub-Zustände

Der Wertebereich umfasst fünf festgelegte Werte, welche die exakte Phase der Kommunikationszustandsmaschine abbilden [SWS_ComM_00674]:

• COMM_NO_COM_NO_PENDING_REQUEST (Wert 0): Kennzeichnet den Zustand innerhalb von No Communication, wenn aktuell keine Kommunikationsanforderung vorliegt [SWS_ComM_00674].
• COMM_NO_COM_REQUEST_PENDING (Wert 1): Kennzeichnet den Zustand innerhalb von No Communication, während eine Anforderung zur Kommunikation anhängig ist [SWS_ComM_00674].
• COMM_FULL_COM_NETWORK_REQUESTED (Wert 2): Kennzeichnet den Zustand innerhalb von Full Communication, bei dem das Netzwerk aktiv angefordert ist [SWS_ComM_00674].
• COMM_FULL_COM_READY_SLEEP (Wert 3): Kennzeichnet den Zustand innerhalb von Full Communication, in dem keine aktiven Anforderungen mehr vorliegen und das Netzwerk bereit zum Einschlafen ist [SWS_ComM_00674].
• COMM_SILENT_COM (Wert 4): Entspricht dem Kommunikationsmodus Silent Communication [SWS_ComM_00674].

Zuordnung zu den Kommunikationsmodi

Die Werte von ComM_StateType stehen in einer direkten Relation zu den übergeordneten Kommunikationsmodi (Communication Modes) des ComM [SWS_ComM_00674]. Alle Zustände mit dem Präfix COMM_NO_COM* sind dem Modus No Communication zugeordnet, während Zustände mit dem Präfix COMM_FULL_COM* dem Modus Full Communication entsprechen [SWS_ComM_00674]. Der Wert COMM_SILENT_COM bildet den gleichnamigen Kommunikationsmodus Silent Communication ab [SWS_ComM_00674].

Der Datentyp ComM_ModeType bildet den aktuellen Kommunikationsmodus und damit den primären Zustand der ComM-Kanal-Zustandsmaschine im Communication Manager ab [SWS_ComM_00672]. Er ist vom Basistyp uint8 abgeleitet und wird über den Header Rte_ComM_Type.h für die Nutzung durch Software-Komponenten und andere BSW-Module bereitgestellt [SWS_ComM_00672].

Der Wertebereich umfasst vier diskrete Betriebsmodi, welche die Kommunikationsfähigkeit des jeweiligen Kanals definieren [SWS_ComM_00672]:

• COMM_NO_COMMUNICATION (0): Der konfigurierte Kanal befindet sich im Ruhezustand und besitzt weder Sende- noch Empfangsfähigkeit [SWS_ComM_00672].
• COMM_SILENT_COMMUNICATION (1): Der Kanal ist auf passive Empfangsfähigkeit beschränkt; das Aussenden von Botschaften ist unterbunden [SWS_ComM_00672].
• COMM_FULL_COMMUNICATION (2): Der Kanal befindet sich im vollen Kommunikationsbetrieb mit aktiver Sende- und Empfangsfähigkeit [SWS_ComM_00672].
• COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST (3): Der Kanal verfügt über Sende- und Empfangsfähigkeit zur unteren Schicht, beispielsweise für Ethernet-Hardware gemäß OPEN Alliance TC10 [SWS_ComM_00672].

Bei der Verwendung gelten wesentliche funktionale Einschränkungen: Der Modus COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST ist mit dem Tag atp.Status=draft versehen und ausdrücklich für den rein internen Gebrauch innerhalb der ComM-Kanal-Zustandsmaschine bestimmt [SWS_ComM_00672]. Externe Anwender oder überlagerte Software-Komponenten dürfen diesen Zustand daher vermutlich weder als Zielmodus anfordern noch über Schnittstellen direkt erwarten. Frage Q-e5f4abe0d6543c82 (offen) Spezifische Fehlercodes, Laufzeitüberprüfungen oder Meldungen an DET oder DEM sind für diesen Typ nicht definiert [SWS_ComM_00672].

Das Spezifikationselement modeLimitation ist gemäß [SWS_ComM_01009] als bereitgestellter Port (Provided Port) des Kommunikationsmanagers (ComM) für das Interface ComM_ECUModeLimitation definiert. Interpretation: Über dieses Port-Interface dürfte das Modul ComM übergeordneten Software-Komponenten oder dem BswM Mechanismen zur gezielten Begrenzung der aktiven Kommunikationsmodi auf Steuergeräteebene zur Verfügung stellen, um beispielsweise den Stromverbrauch oder Betriebsmodi abzusichern. Frage Q-337c6b40bd72cf76 (offen)

Die Bereitstellung dieses Ports im System unterliegt einer expliziten Varianzbedingung: Laut [SWS_ComM_01009] ist das Element ausschließlich dann im System vorhanden, wenn die Konfigurationsoption {ecuc(ComM/ComMGeneral.ComMModeLimitationEnabled)} == true gesetzt ist. Vermutlich führt ein Deaktivieren dieses Parameters dazu, dass der Port während der Codegenerierung entfällt. Frage (offen) Anwendungs- und Basissoftware-Komponenten dürfen diese Schnittstelle daher nur bei aktivierter Option architektonisch anbinden.

Hinsichtlich konkreter Schnittstellenoperationen, Parameter, Reentranz sowie Fehlermeldungen an DET oder DEM enthält [SWS_ComM_01009] keine gesonderten Festlegungen. Integratoren müssen daher vor allem sicherstellen, dass die erforderliche Konfiguration im Container ComMGeneral aktiviert ist, bevor Komponenten mit dem Port modeLimitation verbunden werden.

Der Typ ComMMode ist im Modul ComM als Mode Declaration Group spezifiziert [SWS_ComM_01012]. Das Element ist der Kategorie ALPHABETIC_ORDER zugeordnet und definiert die grundlegenden Kommunikationsmodi des Moduls [SWS_ComM_01012].

Die Gruppe umfasst drei verbindliche Zustände [SWS_ComM_01012]:

• COMM_NO_COMMUNICATION: Dient als Initialmodus der Gruppe [SWS_ComM_01012].
• COMM_SILENT_COMMUNICATION: Repräsentiert einen passiven Kommunikationsmodus [SWS_ComM_01012].
• COMM_FULL_COMMUNICATION: Kennzeichnet den uneingeschränkten Kommunikationsbetrieb [SWS_ComM_01012].

Als initialer Modus ist COMM_NO_COMMUNICATION festgelegt, womit das System standardmäßig ohne aktive Kommunikation startet [SWS_ComM_01012]. Für Übergänge ist kein gesonderter Wert („On transition value“) definiert [SWS_ComM_01012]; Interpretation: Dies bedeutet vermutlich, dass Statuswechsel direkt ohne definierte Zwischenzustände vollzogen werden. Frage Q-f0e73d26f85073b4 (offen) Interpretation: Die Modi dürften den Kommunikationszustand von Kanälen oder Kommunikationsnutzern im Modul abbilden. Frage Q-ef5fa29f6af152c7 (offen) Interpretation: Die Kategorie ALPHABETIC_ORDER dürfte vor allem die standardisierte Aufzählung und Repräsentation für die Schnittstellen der RTE vorgeben. Frage Q-12af3dde3a4cc95e (offen)