Communication Manager (ComM)

De synchrone functie ComM_Init (service-ID 0x01) dient voor de fundamentele initialisatie van de AUTOSAR Communication Manager en herstart de interne toestandsmachines ervan [SWS_ComM_00146]. Als invoerparameter accepteert deze ConfigPtr, die wordt doorgegeven als pointer naar de post-build configuratiestructuur van het type const ComM_ConfigType* [SWS_ComM_00146]. De functie levert geen retourwaarde op (retourtype void) en wordt gedeclareerd via het headerbestand ComM.h [SWS_ComM_00146].

Wat de concurrency betreft is ComM_Init gedefinieerd als niet-re-entrant (Non Reentrant) [SWS_ComM_00146]. Een concrete aanroeper wordt in de specificatiegegevens niet voorgeschreven; vermoedelijk vindt de aanroep centraal plaats tijdens de opstartfase van het regelapparaat in het kader van de BSW-initialisatie. Vraag Q-7121f73c12407087 (open)

In het totale systeem heeft ComM_Init een centrale aansturings- en randvoorwaardefunctie voor de gehele module: zolang de ComM-module niet is geïnitialiseerd, mogen alle module- en API-diensten hun reguliere werking niet starten en moeten zij bij diensten met het standaard retourtype E_NOT_OK terugmelden [SWS_ComM_00612]. Een uitzondering op deze blokkering geldt uitsluitend voor ComM_Init zelf en voor de opvraagfuncties ComM_GetVersionInfo en ComM_GetStatus [SWS_ComM_00612].

Gebruik

De functie ComM_DeInit dient volgens [SWS_ComM_00147] voor de de-initialisatie van de AUTOSAR Communication Manager (ComM). De service is synchroon ontworpen, heeft het service-ID 0x02 en wordt gedeclareerd via het headerbestand ComM.h. Volgens de signatuur void ComM_DeInit(void) accepteert de functie geen enkele invoer-, uitvoer- of overdrachtsparameter en levert deze geen retourwaarde op aan de aanroeper [SWS_ComM_00147].

Foutafhandeling

Aangezien de functiesignatuur void retourneert, vindt via de interface-aanroep geen directe terugkoppeling van fout- of statuscodes plaats [SWS_ComM_00147]. Specifieke foutreacties, zoals het informeren van de Development Error Tracer (DET) of de Diagnostic Event Manager (DEM), zijn niet opgenomen in de beschikbare specificatiegegevens en worden daarom niet vermeld.

Gelijktijdigheid en systeemcontext

Volgens [SWS_ComM_00147] is de interface gespecificeerd als niet-re-entrant (Non Reentrant). Hieruit volgt de dwingende eis aan de systeemintegratie om parallelle of onderbrekende aanroepen vanuit meerdere taken of contexten volledig te verhinderen. Als interpretatie van het systeemverloop mag worden aangenomen dat de aanroep typisch plaatsvindt tijdens de geordende ECU-shutdown door een bovenliggend statusbeheer (zoals de BSW-manager), zodra de communicatiekanalen van de BSW zijn afgesloten. Vraag Q-f3b68dc129993cb7 (open)

Gebruik en aanroepcontext

De synchrone en re-entrante functie ComM_RequestComMode ([SWS_ComM_00110]) dient ertoe een communicatiemodus aan te vragen voor een gedefinieerde gebruiker (User). Deze is beschikbaar via ComM.h. Als overdrachtsparameter voor ComMode zijn uitsluitend de volgende waarden als gebruikersverzoek toegestaan:

• COMM_FULL_COMMUNICATION: Aanvraag van volledige communicatiemogelijkheid ([SWS_ComM_00110]).
• COMM_NO_COMMUNICATION: Vrijgave respectievelijk beëindiging van het communicatieverzoek ([SWS_ComM_00110]).

De modi COMM_SILENT_COMMUNICATION (dient voor de shutdown-synchronisatie) en COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST (interne wake-up-trigger voor onderliggende lagen, bijv. bij OA TC10-capabele Ethernet-hardware) zijn interne toestanden en mogen niet door gebruikers worden aangevraagd ([SWS_ComM_00110]). Interpretatie: Een overdracht van deze interne modi wordt vermoedelijk beantwoord met E_NOT_OK. Vraag Q-973ed1ce1845983e (open)

Retourwaarden en foutafhandeling

De functie signaleert het resultaat via gedefinieerde retourwaarden ([SWS_ComM_00110]):

• E_OK: De overgang naar de gewenste communicatiemodus is succesvol voltooid.
• E_NOT_OK: De modusovergang is mislukt.
• COMM_E_MODE_LIMITATION: De aangevraagde modus kan niet worden toegekend vanwege een actieve communicatiebeperking (Mode Inhibition). Communicatieverzoeken kunnen door dergelijke beperkingen ook weer worden vrijgegeven.

Samenspel en toestandsmachine

De aanwezigheid of afwezigheid van actieve verzoeken beïnvloedt de kanaal-toestandsmachine van de ComM. Bevindt het kanaal zich in de subtoestand COMM_FULL_COM_NETWORK_REQUESTED met de configuratie ComMNmVariant = SLAVE_ACTIVE en is er geen sprake van een actieve aanroep van ComM_RequestComMode(<user>, COMM_FULL_COMMUNICATION), dan gaat de ComM-toestandsmachine over naar de subtoestand COMM_FULL_COM_READY_SLEEP ([SWS_ComM_01017]).

De synchrone functie ComM_UpdatePncToChannelMapping met de service-ID 0x62 dient voor het instellen van gegevens in de PNC-naar-kanaal-toewijzing van de regeleenheid respectievelijk de PNC-gateway [SWS_ComM_91015]. De interface is beschikbaar via het headerbestand ComM.h en in release R20-11 gemarkeerd met de status Draft [SWS_ComM_91015].

Parameter

Aan de functieaanroep worden drie ingangsparameters meegegeven [SWS_ComM_91015]:

• MappingTable: Pointer naar een tweedimensionale boolean-array (const boolean*) die de actuele PNC-naar-kanaal-toewijzing van de PNC-gateway bevat, waarbij de eerste dimensie alle relevante kanalen en de tweede dimensie alle relevante PNC's dekt [SWS_ComM_91015].
• channelCnt: Aantal fysieke kanalen dat in de MappingTable wordt doorgegeven [SWS_ComM_91015].
• PncCnt: Aantal PNC's dat in de MappingTable wordt doorgegeven [SWS_ComM_91015].

Retourwaarden en foutafhandeling

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

• E_OK: De toewijzing is succesvol ingesteld [SWS_ComM_91015].
• E_NOT_OK: Het instellen van de toewijzing is mislukt [SWS_ComM_91015].
• COMM_E_LEARNING_ACTIVE: De aanroep kan niet worden uitgevoerd omdat de PNC-leerfase actief is [SWS_ComM_91015].

Gelijktijdigheid en beperkingen

De interface is gedefinieerd als niet-re-entrant [SWS_ComM_91015]. Aanroepen mogen daarom niet gelijktijdig plaatsvinden. Een bijwerking is bovendien uitgesloten zolang het communicatiesysteem zich in de actieve PNC-leerfase bevindt [SWS_ComM_91015].

De synchrone, niet-re-entrante functie ComM_ResetPncToChannelMapping dient voor het resetten van dynamische elementen van de PNC-naar-kanaal-mapping van de regeleenheid naar de geconfigureerde standaardwaarden [SWS_ComM_91017]. Deze accepteert geen overdrachtsparameters en levert een statuswaarde van het type Std_ReturnType terug [SWS_ComM_91017].

Gedrag en retourwaarden

Het gedrag van de functie hangt af van de toestand van de PNC-leerfase en de configuratie van de kanalen:

• Indien voor ten minste één kanaal ComMDynamicPncToChannelMappingEnabled is geactiveerd en de PNC-leerfase niet actief is, zet de functie de toewijzingen terug naar de standaardwaarden van de oorspronkelijke configuratie (statische elementen) en levert E_OK [SWS_ComM_01043].
• Bevindt het systeem zich in een actieve PNC-leerfase en is voor ten minste één kanaal ComMDynamicPncToChannelMappingEnabled resp. ComMDynamicPncToChannelMappingSupport ingesteld op TRUE, dan wordt de reset geweigerd en COMM_E_LEARNING_ACTIVE geretourneerd [SWS_ComM_01042], [SWS_ComM_01045].
• Als het terugzetten van de toewijzingen naar de standaardwaarden mislukt, retourneert de functie E_NOT_OK [SWS_ComM_91017].

Beperkingen en aanroepvoorwaarden

Aangezien ComM_ResetPncToChannelMapping is gespecificeerd als niet-re-entrant (Non Reentrant), mogen gelijktijdige aanroepen vanuit concurrente contexten niet plaatsvinden [SWS_ComM_91017]. Bovendien bevindt de interface zich in de draft-status [SWS_ComM_91017].

Gebruik en semantiek

De asynchrone functie ComM_PnLearningRequest start de optionele dynamische PNC-naar-kanaal-mapping (Dynamic PNC-to-channel-mapping) [SWS_ComM_91019]. Deze brengt het Network Management (NM) ertoe terug te keren naar de toestand NM Repeat Message State [SWS_ComM_91019]. Daarbij worden de Partial Network Learning Bit, zodat ontvangende knooppunten antwoorden, en de Repeat Message Request Bit verzonden, zodat ontvangende knooppunten eveneens overschakelen naar de toestand NM Repeat Message State [SWS_ComM_91019]. De aanroep vindt plaats zonder overdrachtsparameters via de interface in ComM.h met de service-ID 0x64 [SWS_ComM_91019].

Retourwaarden en foutafhandeling

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

• E_OK: Het PNC-leeralgoritme is succesvol gestart [SWS_ComM_91019].
• E_NOT_OK: Het PNC-leeralgoritme kon niet worden gestart [SWS_ComM_91019].
• COMM_E_LEARNING_ACTIVE: De functieaanroep kan niet worden uitgevoerd omdat de PNC-leerfase reeds actief is [SWS_ComM_91019].

Gelijktijdigheid en configuratie

De functie is gespecificeerd als niet-re-entrant (Non Reentrant) en heeft de status draft [SWS_ComM_91019]. Deze is uitsluitend beschikbaar wanneer de voorconfiguratieparameter ComMDynamicPncToChannelMappingSupport is ingesteld op TRUE [SWS_ComM_01044].

De synchrone en niet-re-entrante functie ComM_UpdatePncMembership wordt gebruikt door software-components (SWC's) om het tijdens het PNC-learning verzonden PNC-lidmaatschap aan te passen voor de optionele dynamische PNC-naar-kanaal-mapping [SWS_ComM_91021]. Deze is via de header ComM.h alleen beschikbaar wanneer de configuratieparameter ComMDynamicPncToChannelMappingSupport is ingesteld op TRUE [SWS_ComM_01047].

Via de parameter ComM_PncMembership wordt een byte-array met de lengte van de PNC-vector doorgegeven, die het actuele PNC-lidmaatschap van het knooppunt bevat [SWS_ComM_91021]. Wanneer de functie op ten minste één kanaal is geactiveerd en de PNC-leerfase inactief is, wordt de parameter Control geëvalueerd [SWS_ComM_01049]:

• Bij Control = 0 wordt het actuele PNC-lidmaatschap berekend door middel van een logische EN-bewerking met ComM_PncMembership, om betreffende bits in het masker gericht te resetten [SWS_ComM_01049].
• Bij Control = 1 wordt een logische OF-bewerking toegepast om bits in het masker in te stellen [SWS_ComM_01049].

Was het bijwerken succesvol, dan levert de functie E_OK terug [SWS_ComM_01049]. Is daarentegen op ten minste één kanaal de dynamische toewijzing geconfigureerd en de PNC-leerfase actief, dan wordt de uitvoering geweigerd en de specifieke foutwaarde COMM_E_LEARNING_ACTIVE gemeld [SWS_ComM_01048]. Treedt tijdens het bijwerkproces een andere fout op, dan wordt E_NOT_OK geretourneerd [SWS_ComM_91021].

Gebruik en aanroepcontext

De functie ComM_PreventWakeUp dient er volgens [SWS_ComM_00156] voor om de inhibitie-status COMM_NO_WAKEUP voor een bepaald communicatiekanaal te wijzigen. Deze wordt synchroon uitgevoerd en is beschikbaar via het headerbestand ComM.h.

Bij de aanroep worden twee invoerparameters meegegeven:

• Channel: Identificeert het betreffende kanaal volgens het type NetworkHandleType ([SWS_ComM_00156]).
• Status: Een booleaanse waarde waarmee de wake-up-inhibitie wordt geactiveerd (TRUE) of gedeactiveerd (FALSE) ([SWS_ComM_00156]).

Retourwaarden en foutafhandeling

Als retourwaarde levert de functie de status Std_ReturnType conform [SWS_ComM_00156]:

• E_OK: De wake-up-status voor het opgegeven kanaal is succesvol bijgewerkt.
• E_NOT_OK: Het wijzigen van de wake-up-status is mislukt, bijvoorbeeld wanneer de functionaliteit via de ECU-groepsclassificatie (ComMEcuGroupClassification) is gedeactiveerd.

Gelijktijdigheid en beperkingen

De interface is gespecificeerd als niet-re-entrant (Non Reentrant) ([SWS_ComM_00156]). Aanroepers moeten er daarom voor zorgen dat parallelle aanroepen voor dezelfde instantie worden vermeden.

De synchrone functie ComM_LimitChannelToNoComMode met het service-ID 0x0b dient er in de Communication Manager voor om de inhibitie-status voor een afzonderlijk communicatiekanaal vast te leggen [SWS_ComM_00163]. Deze verhindert of staat de overgang van het kanaal van de toestand COMM_NO_COMMUNICATION naar een bovenliggende communicatiemodus toe [SWS_ComM_00163].

Parameters en aanroepcontext

De interface is gedeclareerd via het headerbestand ComM.h en heeft noch invoer-/uitvoer-, noch zuivere uitvoerparameters [SWS_ComM_00163]. Bij de aanroep worden twee invoerparameters doorgegeven [SWS_ComM_00163]:

• Channel: Adresseert het respectieve kanaal via de identifier van het type NetworkHandleType [SWS_ComM_00163].
• Status: Bepaalt als boolean de gewenste inhibitie-toestand. Het meegeven van TRUE activeert de beperking van het kanaal tot COMM_NO_COMMUNICATION, terwijl FALSE deze limitering weer deactiveert [SWS_ComM_00163].

Retourwaarden en foutafhandeling

De functie retourneert een waarde van het type Std_ReturnType aan de aanroeper [SWS_ComM_00163]:

• E_OK: De inhibitie-status voor het geadresseerde kanaal is met succes aangepast [SWS_ComM_00163].
• E_NOT_OK: De statuswijziging kon niet worden uitgevoerd, wat bijvoorbeeld het geval is wanneer de configuratie ComMEcuGroupClassification (zie ECUC_ComM_00563) de functionaliteit deactiveert [SWS_ComM_00163].

Gelijktijdigheid en systeemrelatie

Wat betreft het uitvoeringsgedrag is de functie synchroon (Synchronous) en niet-re-entrant (Non Reentrant) uitgevoerd [SWS_ComM_00163]. Voor hetzelfde doel op het niveau van het totale systeem bestaat de verwante functie ComM_LimitECUToNoComMode, die dezelfde beperking niet alleen kanaalgebonden, maar uniform voor alle kanalen van de ECU implementeert [SWS_ComM_00163].

Gebruik

De synchrone functie ComM_LimitECUToNoComMode (service-ID 0x0c) is gedefinieerd in ComM.h en dient ertoe de inhibitie-status voor het gehele regelapparaat te wijzigen [SWS_ComM_00124]. Deze verhindert of staat de overgang toe van COMM_NO_COMMUNICATION naar een hogere communicatiemodus voor alle communicatiekanalen van de ECU [SWS_ComM_00124]. De besturing vindt plaats via de formele parameter Status:

• TRUE: Activeert de beperking van het regelapparaat tot de modus COMM_NO_COMMUNICATION [SWS_ComM_00124].
• FALSE: Deactiveert de beperking van het regelapparaat tot COMM_NO_COMMUNICATION weer [SWS_ComM_00124].

Foutafhandeling en retourwaarden

De functie retourneert een statuscode van het type Std_ReturnType aan de aanroeper [SWS_ComM_00124]:

• E_OK: De inhibitie-status voor het regelapparaat is succesvol overgenomen [SWS_ComM_00124].
• E_NOT_OK: De wijziging van de inhibitie-status is mislukt, bijvoorbeeld wanneer de configuratieparameter ComMEcuGroupClassification (zie ECUC_ComM_00563) de functionaliteit deactiveert [SWS_ComM_00124].

Een aanroeper moet de retourwaarde evalueren om te herkennen of de beperking effectief kon worden geactiveerd of door de moduleconfiguratie werd afgewezen [SWS_ComM_00124].

Gelijktijdigheid en wisselwerking

De interface is gedeclareerd als niet-re-entrant (Non Reentrant); parallelle of onderbrekende aanroepen zijn daarom ontoelaatbaar en moeten aan de zijde van de aanroeper worden vermeden [SWS_ComM_00124]. Terwijl ComM_LimitChannelToNoComMode dezelfde besturingsfunctionaliteit geïsoleerd voor een afzonderlijk kanaal biedt, heeft ComM_LimitECUToNoComMode altijd betrekking op het geheel van alle kanalen van het regelapparaat [SWS_ComM_00124].

Gebruik en aanroepcontext

De synchrone functie ComM_ReadInhibitCounter (service-ID 0x0d) dient om het aantal geweigerde gebruikersverzoeken voor volledige communicatiewerking (COMM_FULL_COMMUNICATION) op te vragen [SWS_ComM_00224]. De functiedeclaratie wordt bereitgesteld via het headerbestand ComM.h [SWS_ComM_00224].

De functie heeft geen invoerparameters. Als enige uitvoerparameter dient de pointer CounterValue van het basistype uint16*, waarmee de tellerstand voor de afgewezen verzoeken aan de aanroeper wordt doorgegeven [SWS_ComM_00224]. Als de tellerstand met succes kon worden bepaald en geschreven, levert de functie E_OK op; bij een mislukking retourneert deze E_NOT_OK [SWS_ComM_00224].

Foutafhandeling

Specifieke foutcodes of gestandaardiseerde ontwikkelingsfouten (DET) zijn in de interfacebeschrijving niet afzonderlijk vermeld. Een mislukking met de retourwaarde E_NOT_OK [SWS_ComM_00224] is vermoedelijk te wijten aan een ongeldige pointerparameter (null-pointer) of een aanroep vóór de initialisatie van de ComM-module (interpretatie). Vraag Q-5779d898381d9894 (open)

Gelijktijdigheid en beperkingen

De interface is expliciet als niet-re-entrant (Non Reentrant) gespecificeerd [SWS_ComM_00224]. Aanroepers moeten daarom op systeemniveau waarborgen dat er geen gelijktijdige of onderbrekende aanroepen via verschillende taken of interrupt-service-routines plaatsvinden, om inconsistenties bij het uitlezen van de teller te voorkomen.

Gebruik en werking

De synchrone interface ComM_ResetInhibitCounter dient ertoe de interne teller voor geweigerde of verhinderde volledige-communicatie-aanvragen (Inhibited COMM_FULL_COMMUNICATION request Counter) in de Communication Manager te resetten [SWS_ComM_00108]. De aanroep wordt beschikbaar gesteld via de header ComM.h, heeft de service-ID 0x0e en vereist geen overdrachtsparameters [SWS_ComM_00108]. Bij succesvolle uitvoering levert de functie de retourwaarde E_OK van het type Std_ReturnType [SWS_ComM_00108].

Foutafhandeling en randvoorwaarden

Treedt er bij het resetten van de teller een fout op, dan signaleert de service dit via de retourwaarde E_NOT_OK [SWS_ComM_00108]. Concrete ontwikkelfouten (DET) of foutscenario's zijn in het onderhavige specificatie-uittreksel niet vermeld; vermoedelijk mislukt de uitvoering en levert deze E_NOT_OK op wanneer de module nog niet is geïnitialiseerd. Vraag Q-31d1ba95e419fa8e (open)

Concurrency

De functie is gedeclareerd als niet-re-entrant (Non Reentrant) [SWS_ComM_00108]. Gebruikers moeten daarom door middel van geschikte synchronisatie waarborgen dat er geen parallelle aanroepen vanuit meerdere threads, taken of interrupt-serviceroutines plaatsvinden, om inconsistenties in de teller te voorkomen.

De functie ComM_Nm_NetworkStartIndication dient als notificatie-interface van het netwerkbeheer aan de Communication Manager. Conform [SWS_ComM_00383] geeft deze aan dat tijdens de toestand Bus Sleep Mode een NM-bericht is ontvangen, wat signaleert dat bepaalde knooppunten in het netwerk reeds naar de Network Mode zijn overgeschakeld.

• Aanroep en parameters: De interface wordt gedeclareerd via de header ComM_Nm.h en accepteert als invoerparameter het betreffende communicatiekanaal Channel van het type NetworkHandleType [SWS_ComM_00383].
• Synchroniciteit en teruggave: De aanroep heeft geen retourwaarde (void) en volgt een asynchrone uitvoeringssemantiek [SWS_ComM_00383].
• Gelijktijdigheid: De functie is voorzien van de service-ID 0x15 en gespecificeerd als re-entrant (Reentrant) [SWS_ComM_00383].

Specifieke foutcodes, DET- of DEM-meldingen en afzonderlijke foutreacties zijn voor deze interface in de specificatie niet vermeld [SWS_ComM_00383]. Interpretatie: De indicatie zal intern vermoedelijk bedoeld zijn om de overgang vanuit de rusttoestand naar actieve netwerkcommunicatie voor het opgegeven kanaal in te leiden. Vraag Q-97a02db4ab6a3af8 (open)

De functie ComM_Nm_NetworkMode fungeert in de AUTOSAR-communicatiemanager (ComM) als notificatie-callback waarmee het netwerkbeheer (Nm) signaleert dat de netwerkmodus (Network Mode) met succes is aangenomen [SWS_ComM_00390].

Aanroep en parameters

De interface is beschikbaar via het headerbestand ComM_Nm.h en heeft de service-ID 0x18 [SWS_ComM_00390]. Bij de aanroep wordt via de enige ingangsparameter Channel van het type NetworkHandleType het desbetreffende communicatiekanaal doorgegeven [SWS_ComM_00390]. De functie levert geen retourwaarde op (retourtype void) en beschikt niet over uitgangsparameters [SWS_ComM_00390].

Gelijktijdigheid en semantiek

Het uitvoeringsgedrag van ComM_Nm_NetworkMode is gedeclareerd als asynchroon (Asynchronous) [SWS_ComM_00390]. Met betrekking tot gelijktijdigheid is de functie gespecificeerd als re-entrant (Reentrant), zodat deze voor parallelle kanaalgebeurtenissen herintredend kan worden aangeroepen [SWS_ComM_00390].

Foutafhandeling

Aangezien de signatuur niet voorziet in een retourwaarde, worden er geen foutcodes direct aan de aanroeper doorgegeven [SWS_ComM_00390].

De functie ComM_Nm_PrepareBusSleepMode dient als notificatie-interface van de Communication Manager (ComM). Deze informeert de ComM erover dat het netwerkbeheer voor het aangegeven communicatiekanaal is overgegaan naar de toestand „Prepare Bus - Sleep Mode” [SWS_ComM_00391].

Gebruik en signatuur

De interface is beschikbaar via het headerbestand ComM_Nm.h en heeft de service-ID 0x19 [SWS_ComM_00391]. De uitvoering verloopt asynchroon [SWS_ComM_00391]. De functiesignatuur omvat de volgende parameters:

• Channel (In, NetworkHandleType): identificeert het desbetreffende netwerkkanaal waarvan het netwerkbeheer de prepare-bus-sleep-modus heeft aangenomen [SWS_ComM_00391].
• Retourwaarde: void; er worden geen status- of foutwaarden geretourneerd en er worden geen in-/uitgangsparameters gevoerd [SWS_ComM_00391].

Gelijktijdigheid en beperkingen

Met betrekking tot gelijktijdigheid is ComM_Nm_PrepareBusSleepMode gespecificeerd als re-entrant, echter met de bindende beperking dat dit niet geldt voor hetzelfde NM-kanaal (Reentrant (but not for the same NM - Channel)) [SWS_ComM_00391]. Aanroepen voor verschillende kanalen mogen daarom parallel plaatsvinden, terwijl gelijktijdige aanroepen voor hetzelfde kanaal moeten worden uitgesloten.

Aanroepcontext en foutafhandeling

Interpretatie: de aanroepcontext ligt vermoedelijk in het generieke of busspecifieke Network Management, dat het bereiken van deze toestand aan de ComM meldt. Vraag Q-41524322db480310 (open) Specifieke foutcodes, DET- of DEM-meldingen zijn voor deze interface in de specificatie niet gedefinieerd [SWS_ComM_00391].

Gebruik

De callback-functie ComM_Nm_BusSleepMode dient als notificatie aan de module ComM dat het netwerkbeheer naar de bus-sleep-modus is overgegaan [SWS_ComM_00392]. Middels deze aanroep moet de functie de omschakeling van de bijbehorende hardware en de transceiver naar de bus-sleep-modus uitvoeren [SWS_ComM_00392].

Interface en parameters

De functie wordt beschikbaar gesteld via het headerbestand ComM_Nm.h en voert de service-ID 0x1a [SWS_ComM_00392]. De aanroep geschiedt via de signatuur void ComM_Nm_BusSleepMode (NetworkHandleType Channel) met de volgende parametereigenschappen [SWS_ComM_00392]:

• Channel: ingangsparameter van het type NetworkHandleType, die het desbetreffende communicatiekanaal identificeert [SWS_ComM_00392].
• Voor deze functie zijn noch in-/uitgangsparameters noch uitgangsparameters voorzien [SWS_ComM_00392].
• Er is geen retourwaarde gedefinieerd (void) [SWS_ComM_00392].

Gelijktijdigheid en beperkingen

Met betrekking tot het uitvoeringsgedrag en mogelijke beperkingen specificeert de eis de volgende randvoorwaarden [SWS_ComM_00392]:

• Asynchrone semantiek: de aanroep is geclassificeerd als asynchroon (Asynchronous) [SWS_ComM_00392].
• Re-entrantie: de functie is gedefinieerd als re-entrant (Reentrant) [SWS_ComM_00392].

De callback-functie ComM_Nm_RestartIndication met de service-ID 0x1b wordt aangeroepen door het NM-Interface en is gedeclareerd via het headerbestand ComM_Nm.h [SWS_ComM_00792]. Deze dient ertoe de Communication Manager op de hoogte te stellen van de herstart van het netwerkbeheer tijdens een lopende uitschakelprocedure van gecoördineerde bussen [SWS_ComM_00792]. De enige invoerparameter Channel van het type NetworkHandleType specificeert het betrokken kanaal; de operatie levert geen retourwaarde op [SWS_ComM_00792].

De interface is gespecificeerd als asynchroon en re-entrant [SWS_ComM_00792]. De aanroep ervan door het NM-Interface vindt plaats wanneer tegelijkertijd aan drie voorwaarden is voldaan:

• Het NM-Interface is al begonnen met het afsluiten van de gecoördineerde bussen [SWS_ComM_00792].
• Nog niet alle van deze gecoördineerde bussen hebben de bus-sleep-toestand gemeld [SWS_ComM_00792].
• Op ten minste één van de gecoördineerde bussen wordt het netwerkbeheer opnieuw gestart [SWS_ComM_00792].

Als aan deze voorwaarden is voldaan, roept het NM-Interface de functie specifiek aan met de handle van die kanalen die de bus-sleep-toestand al hadden gesignaleerd [SWS_ComM_00792].

Specifieke foutcodes, foutreacties of meldingen aan de ontwikkeltest- of foutgeheugenmodule (DET/DEM) zijn in het specificatie-uittreksel niet voorzien [SWS_ComM_00792]. Interpretatie: De functie zou in de ComM bedoeld moeten zijn om de interne toestand van reeds slapende kanalen weer in overeenstemming te brengen met de opnieuw geactiveerde buscoördinatie. Vraag (open)

Gebruik

De functie ComM_Nm_RepeatMessageLeftIndication dient als notificatie-interface die aan de ComM signaleert dat de toestand van alle bus-NM-modules (<Bus Nm>) de toestand Repeat Message heeft verlaten [SWS_ComM_91024]. In het kader van het optionele functionele kenmerk voor dynamische toewijzing van Partial Network Clusters aan kanalen (Dynamic PNC-to-channel-mapping) geeft deze aanroep aan dat de leerfase eindigt [SWS_ComM_91024].

De interface wordt gedeclareerd via de header ComM_Nm.h en heeft geen retourwaarde (void) [SWS_ComM_91024]. Als overdrachtsparameter wordt het betreffende communicatiekanaal overgedragen:

• Channel (In, NetworkHandleType): Identificatie van het kanaal waarvoor het verlaten van de toestand wordt gemeld [SWS_ComM_91024].

Samenspel en functionele werking

Het gedrag van de indicatie bestuurt de PNC-leerfase: Voor zover de configuratieparameter ComMDynamicPncToChannelMappingEnabled is ingesteld op TRUE en ComM_Nm_RepeatMessageLeftIndication wordt aangeroepen, zet de ComM de PNC-leerfase (PNC Learning Phase) voor het corresponderende kanaal op inactief [SWS_ComM_01029] [SWS_ComM_01046].

Gelijktijdigheid en beperkingen

De interface is gespecificeerd als re-entrant en heeft een asynchrone uitvoeringssemantiek [SWS_ComM_91024]. In de onderhavige specificatie is het element bovendien gekenmerkt met de ontwikkelstatus draft [SWS_ComM_91024].

De functie ComM_Nm_PncLearningBitIndication dient als notificatie-interface voor de module ComM om de ontvangst van een NM-bericht met ingestelde PNC-learning-bit aan te geven [SWS_ComM_91026]. De interface heeft de service-ID 0x69, wordt beschikbaar gesteld via het headerbestand ComM_Nm.h en is in de specificatie gemarkeerd met de status „draft” [SWS_ComM_91026].

Wat betreft gebruik en signatuur gelden de volgende bepalingen:

• Parameters: Als invoerparameter wordt Channel van het type NetworkHandleType doorgegeven, die het betreffende communicatiekanaal identificeert [SWS_ComM_91026]. Er zijn noch invoer-/uitvoerparameters noch uitvoerparameters, en het retourtype is void [SWS_ComM_91026].
• Gelijktijdigheid: De aanroep is gespecificeerd als asynchroon en re-entrant [SWS_ComM_91026]. Afgaande op de identifier en de header zal de aanroep typisch door de onderliggende NM-module plaatsvinden zodra een corresponderend NM-bericht is ontvangen. Vraag Q-31b0ce30b88c71b6 (open)
• Foutafhandeling: Binnen de specificatieomvang zijn voor deze service noch retourwaarden noch specifieke foutcodes of meldingen aan DET resp. DEM gedocumenteerd.

In het samenspel met de dynamische PNC-mapping bestuurt de functie de activering van de leerfase: Wordt ComM_Nm_PncLearningBitIndication aangeroepen op een kanaal waarvoor de configuratieparameter ComMDynamicPncToChannelMappingEnabled is ingesteld op TRUE, dan moet ComM de PNC-leerfase (PNC Learning Phase) voor dit kanaal op actief zetten [SWS_ComM_01026]. Dezelfde toestand van een actieve leerfase op het betreffende kanaal triggert ComM volgens de specificatie ook wanneer de module zelf Nm_PnLearningRequest aanroept [SWS_ComM_01026].

De synchrone en re-entrante functie ComM_Nm_ForwardSynchronizedPncShutdown (service-ID 0x6b) wordt gedeclareerd via de header ComM_Nm.h en dient voor het gecoördineerd doorsturen van een gesynchroniseerde PNC-shutdown [SWS_ComM_91003].

Gebruik en aanroepcontext: Deze wordt aangeroepen wanneer een regeleenheid in de rol van intermediate PNC coordinator een PN-shutdown-bericht via een busspecifieke NM ontvangt [SWS_ComM_91003]. Als enige invoerparameter wordt het betreffende communicatiekanaal (Channel van het type NetworkHandleType) doorgegeven. Een retourwaarde is niet gedefinieerd (void) [SWS_ComM_91003].

Samenspel en verloop: Na de indicatie geeft de ComM onmiddellijk de betreffende PNC-toestandsmachines vrij. Bovendien stuurt deze de PN-informatie direct door naar de betreffende ComM-kanalen en de corresponderende NM-kanalen [SWS_ComM_91003]. Daardoor wordt een grotendeels synchrone PNC-shutdown over de hiërarchische PN-topologie van de bovengeschikte top-level-coördinator tot aan de ondergeschikte PNC-knooppunten gewaarborgd [SWS_ComM_91003].

Foutafhandeling en randvoorwaarden: Aangezien de interface geen retourwaarde heeft en er geen specifieke foutcodes zijn gedocumenteerd, zal foutafhandeling vermoedelijk intern of via de DET plaatsvinden. Vraag Q-618a8c1da055cdf5 (open) Het element is in release R20-11 geclassificeerd als Draft [SWS_ComM_91003].

Gebruik en aanroepcontext

De synchrone interface ComM_DCM_ActiveDiagnostic dient voor de Diagnostic Communication Manager (DCM) om de Communication Manager (ComM) te informeren over actieve diagnose-activiteiten op een bepaald communicatiekanaal [SWS_ComM_00873]. De functie is gedefinieerd in het headerbestand ComM_Dcm.h en aangeduid met het service-ID 0x1f [SWS_ComM_00873].

Als enige aanroepparameter fungeert de invoerparameter Channel van het datatype NetworkHandleType, die het betreffende kanaal voor de komende diagnosecommunicatie eenduidig identificeert [SWS_ComM_00873]. De interface heeft geen retourwaarde (retourtype void), en er bestaan noch invoer-/uitvoer-, noch uitvoerparameters [SWS_ComM_00873].

Gelijktijdigheid en beperkingen

Wat betreft gelijktijdigheid is het service-element gespecificeerd als re-entrant [SWS_ComM_00873]. Dit maakt parallelle synchrone aanroepen van de functie vanuit verschillende uitvoeringscontexten mogelijk, bijvoorbeeld wanneer de DCM meerdere netwerkkanalen gelijktijdig moet beheren of bedienen.

Foutafhandeling en wisselwerking

Voor deze aanroep zijn geen afzonderlijke foutcodes of meldingen aan het ontwikkelingsfoutbeheer (DET) of het diagnose-foutgeheugenbeheer (DEM) vastgelegd [SWS_ComM_00873]. De interactie blijft beperkt tot de signaaluitwisseling tussen DCM en ComM; interpretatie: de aanroep zal er in de ComM vermoedelijk voor worden gebruikt om het desbetreffende kanaal voor de duur van de diagnose-activiteit in de actieve communicatietoestand te houden [SWS_ComM_00873]. Vraag Q-bfd91da2e435fbb6 (open)

Gebruik

De synchrone functie ComM_DCM_InactiveDiagnostic dient ertoe dat de Diagnostic Communication Manager (DCM) aan de Communication Manager (ComM) aangeeft dat de diagnosecommunicatie op een bepaald kanaal inactief is en niet langer nodig is [SWS_ComM_00874]. De declaratie van deze interface wordt beschikbaar gesteld via het headerbestand ComM_Dcm.h met de service-ID 0x20 [SWS_ComM_00874].

Als invoerparameter wordt Channel van het type NetworkHandleType doorgegeven, die het desbetreffende communicatiekanaal identificeert [SWS_ComM_00874]. De functie heeft noch invoer-/uitvoerparameters noch uitvoerparameters en retourneert geen waarde (void) [SWS_ComM_00874].

Gelijktijdigheid en foutafhandeling

De interface is gespecificeerd als re-entrant [SWS_ComM_00874], zodat gelijktijdige aanroepen – bijvoorbeeld voor verschillende communicatiekanalen – zijn toegestaan. Specifieke foutcodes, DET-foutmeldingen of DEM-gebeurtenissen zijn voor deze functie niet gedefinieerd in de payload [SWS_ComM_00874]. De ComM-module zou de inactiviteitsmelding intern moeten gebruiken om bestaande diagnoseverzoeken voor het kanaal in te trekken en de kanaalstatus dienovereenkomstig aan te passen. Vraag Q-148d39d8c17e936c (open)

De functie ComM_EcuM_WakeUpIndication dient voor de notificatie van de Communication Manager (ComM) over een opgetreden wake-up-gebeurtenis op het desbetreffende communicatiekanaal [SWS_ComM_00275]. De aanroep vindt vermoedelijk typisch plaats door de ECU State Manager (EcuM), zodra deze een overeenkomstige wake-up op een kanaal heeft geregistreerd. Vraag Q-5f8c43b9df10dc8e (open)

Gebruik en aanroepcontext

De interface is synchroon gedefinieerd en heeft de service-ID 0x2a [SWS_ComM_00275]. Via de ingangsparameter Channel van het type NetworkHandleType wordt de identifier van het communicatiekanaal doorgegeven waarop de wake-up is gedetecteerd [SWS_ComM_00275]. De functie heeft geen retourwaarde (void) en wordt gedeclareerd via het headerbestand ComM_EcuM.h [SWS_ComM_00275].

Gelijktijdigheid en beperkingen

Volgens de specificatie is ComM_EcuM_WakeUpIndication geclassificeerd als re-entrant [SWS_ComM_00275]. Daardoor mag de functie parallel voor verschillende kanalen of vanuit gelijktijdige contexten worden aangeroepen. Specifieke foutcodes, retourwaarden of DET-/DEM-meldingen zijn in de elementdefinitie niet aangewezen [SWS_ComM_00275].

Gebruik en aanroepcontext

De synchrone functie ComM_EcuM_PNCWakeUpIndication dient voor de kennisgeving aan de Communication Manager van een wake-up op een Partial Network Cluster (PNC) [SWS_ComM_91001]. Deze wordt gedeclareerd via de header ComM_EcuM.h en verwacht als invoerparameter PNCid de identificatie van het betreffende cluster; retourwaarden zijn er niet [SWS_ComM_91001]. Interpretatie: de aanroep vindt typisch plaats door de ECU State Manager (EcuM) bij detectie van een overeenkomstig PNC-event. Vraag Q-fee4a70f73cde8ea (open)

Gelijktijdigheid en toestandsovergangen

De interface is gespecificeerd als re-entrant [SWS_ComM_91001]. De aanroep ervan bewerkt gerichte toestandsveranderingen binnen de PNC- en kanaal-state-machines van de ComM:

• Als het gereferentieerde cluster zich in de PNC-hoofdtoestand PNC_NO_COMMUNICATION bevindt, wordt deze verlaten en wordt overgegaan naar de PNC-subtoestand PNC_PREPARE_SLEEP [SWS_ComM_00964].
• Vindt de aanroep plaats in de subtoestand COMM_NO_COM_NO_PENDING_REQUEST bij geactiveerde PNC-ondersteuning (ComMPncSupport=TRUE) en gedeactiveerde synchrone wake-up (ComMSynchronousWakeUp=FALSE), dan brengt de module die ComM-kanaal-state-machines naar de subtoestand COMM_NO_COM_REQUEST_PENDING die door de opgegeven PNC worden gereferentieerd [SWS_ComM_01014].
• Is daarentegen ComMSynchronousWakeUp=TRUE geconfigureerd bij actieve ComMPncSupport, dan schakelt de aanroep in de subtoestand COMM_NO_COM_NO_PENDING_REQUEST zonder uitzondering alle ComM-kanaal-state-machines naar de subtoestand COMM_NO_COM_REQUEST_PENDING [SWS_ComM_01015].

Via de functie ComM_CommunicationAllowed ([SWS_ComM_00871]) wordt aan de module ComM door EcuM of BswM aangegeven of communicatie voor een bepaald kanaal is vrijgegeven.

Gebruik en aanroepcontext

De interface wordt aangeroepen door de module EcuM of BswM; indien EcuM Flex wordt ingezet, neemt BswM deze taak over ([SWS_ComM_00871]). De functie is gedeclareerd via de header ComM_BswM.h en heeft het service-ID 0x35 ([SWS_ComM_00871]).

De functie heeft geen retourwaarde (void) en verwacht de volgende overdrachtsparameters ([SWS_ComM_00871]):

• Channel (type NetworkHandleType): Duidt het betreffende communicatiekanaal aan ([SWS_ComM_00871]).
• Allowed (type boolean): Geeft de vrijgavestatus door met TRUE voor toegestane communicatie respectievelijk FALSE voor niet-toegestane communicatie ([SWS_ComM_00871]).

Gelijktijdigheid en beperkingen

De functie werkt volgens de specificatie asynchroon (Asynchronous) en is geclassificeerd als niet-re-entrant (Non Reentrant) ([SWS_ComM_00871]). Vanwege het niet-re-entrant zijn moet de aanroeper er vermoedelijk voor zorgen dat er geen parallelle of onderbrekende aanroepen voor de interface plaatsvinden. Vraag Q-e6688e3286d9ed60 (open)

Gebruik en signatuur

De interface ComM_BusSM_ModeIndication dient voor de indicatie van de feitelijke busmodus door de verantwoordelijke Bus State Manager aan de module ComM [SWS_ComM_00675]. De C-functie is beschikbaar via de header ComM.h en is geregistreerd onder de service-ID 0x33 [SWS_ComM_00675]. De syntaxis luidt void ComM_BusSM_ModeIndication (NetworkHandleType Channel, ComM_ModeType ComMode) [SWS_ComM_00675].

De functie accepteert twee invoerparameters:

• Channel: Het betrokken communicatiekanaal van het type NetworkHandleType [SWS_ComM_00675].
• ComMode: De feitelijke modus van de bus van het type ComM_ModeType [SWS_ComM_00675].

De interface heeft geen retourwaarde (void) en definieert noch invoer-/uitvoerparameters noch zuivere retourparameters [SWS_ComM_00675].

Gelijktijdigheid en synchronisatie

Voor het runtime-gedrag is vastgelegd dat de aanroep asynchroon (Asynchronous) plaatsvindt en de functie re-entrant (Reentrant) kan worden uitgevoerd [SWS_ComM_00675].

Samenspel in het totale systeem

De module ComM geeft de via deze aanroep gemelde toestand door aan de gebruikers [SWS_ComM_00675]. Deze propagatie van de bustoestand verloopt via de interfaces van de RTE en de BswM [SWS_ComM_00675].

Gebruik

De synchrone servicefunctie ComM_BusSM_BusSleepMode dient voor de verantwoordelijke Bus State Manager (BusSM) als notificatie aan de Communication Manager (ComM) dat de feitelijke busmodus van een communicatiekanaal is gewisseld naar de toestand Bus-Sleep [SWS_ComM_91000]. De identificatie van het betrokken kanaal vindt plaats via de ingangsparameter Channel van het type NetworkHandleType [SWS_ComM_91000]. De functie declareert noch uitvoerparameters noch een retourwaarde (void) [SWS_ComM_91000].

Configuratieafhankelijke geldigheid

De aanroep is niet universeel toegestaan, maar expliciet beperkt tot ComM-kanalen waarvan de parameter ComMNmVariant is ingesteld op SLAVE_ACTIVE of SLAVE_PASSIVE [SWS_ComM_91000]. De specificatie noemt hiervoor twee typische toepassingsscenario's:

• LIN-slaves met de configuratie ComMNmVariant = SLAVE_ACTIVE [SWS_ComM_91000].
• Ethernet-kanalen met hardware conform OPEN Alliance TC10 die als passieve communicatie-slaves worden gebruikt, waarbij ComMNmVariant = SLAVE_PASSIVE en de parameter EthTrcvActAsSlavePassiveEnabled is vastgelegd op TRUE [SWS_ComM_91000].

Gelijktijdigheid en integratie

De interface heeft de service-ID 0x34, is gedeclareerd via het headerbestand ComM.h en als re-entrant geclassificeerd [SWS_ComM_91000]. Specifieke foutcodes of een afzonderlijk gedrag bij fouten zijn in de functiedefinitie niet vermeld [SWS_ComM_91000].

Het enumeratietype ComM_InitStatusType dient voor de weergave van de initialisatiestatus van de module ComM (COM Manager) en is beschikbaar via het headerbestand ComM.h [SWS_ComM_00668].

Het waardebereik omvat precies twee toestanden ter onderscheiding van de operationele gereedheid [SWS_ComM_00668]:

• COMM_UNINIT (gecodeerd met de waarde 0x00 resp. 0): Geeft aan dat de COM Manager niet geïnitialiseerd of niet bruikbaar is. Deze toestand is verplicht de standaardwaarde direct na een reset [SWS_ComM_00668].
• COMM_INIT (gecodeerd met de waarde 0x01): Geeft aan dat de COM Manager correct is geïnitialiseerd en gereed is voor gebruik [SWS_ComM_00668].

Wat betreft de temporele volgorde en het modulegebruik markeert deze status de principiële bruikbaarheid van de COM Manager [SWS_ComM_00668]. Interpretatie: Aanroepers of interne moduleroutines zouden deze status moeten evalueren om te waarborgen dat er geen communicatieverzoeken in de toestand COMM_UNINIT worden verwerkt, aangezien de COM Manager in deze toestand expliciet als niet bruikbaar is gespecificeerd [SWS_ComM_00668]. Vraag Q-2c4da2e5c40a0f4b (open) Pas na de succesvolle overgang naar COMM_INIT staat de module ter beschikking voor overkoepelende interacties.

Het enumeratietype ComM_PncModeType definieert de actuele bedrijfstoestand van een Partial Network Cluster (PNC) in de Communication Manager [SWS_ComM_00673]. Het type wordt beschikbaar gesteld via het headerbestand ComM.h en omvat vijf discrete toestanden [SWS_ComM_00673]:

• COMM_PNC_REQUESTED (0x00): De PNC wordt aangevraagd door een lokale ComM-gebruiker.
• COMM_PNC_READY_SLEEP (0x01): De PNC wordt aangevraagd door een externe ComM-gebruiker.
• COMM_PNC_PREPARE_SLEEP (0x02): De PNC is actief, maar zonder bewaking van termijnen (Deadline Monitoring).
• COMM_PNC_NO_COMMUNICATION (0x03): Voor de PNC vindt geen communicatie plaats.
• COMM_PNC_REQUESTED_WITH_WAKEUP_REQUEST (0x04): Lokale PNC-aanvraag met extra verzoek tot hardware-ontwaking aan de BswM.

In samenspel met de BswM dient de modus COMM_PNC_REQUESTED_WITH_WAKEUP_REQUEST ertoe te signaleren dat een actieve aanvraag tevens het wekken van de communicatiehardware moet triggeren [SWS_ComM_00673]. Dit vereist dat de functie wordt ondersteund en geconfigureerd, bijvoorbeeld bij port-switching van Ethernet-switches conform OA TC10 [SWS_ComM_00673]. Als beperking moet in acht worden genomen dat deze modus in release R20-11 is voorzien van de status draft [SWS_ComM_00673].

Aangezien het om een zuivere typedefinitie gaat, bestaan er voor ComM_PncModeType geen eigen foutafhandelingsroutines of re-entrantievoorschriften.

Interpretatie: Aangezien het type in ComM.h is gedeclareerd en de BswM als ontvanger van de modusinformatie wordt geadresseerd, zou het datatype module-overstijgend als interfaceparameter voor PNC-statusmeldingen kunnen worden gebruikt. Vraag Q-88ad945ffcf90e9e (open)

Gebruik en definitie

Het type ComM_StateType vertegenwoordigt de toestanden en subtoestanden van de interne state-machine van de Communication Manager (ComM) in het AUTOSAR Classic Platform [SWS_ComM_00674]. Het is gedefinieerd als een zelfstandig type op basis van het standaardtype uint8 en wordt via het headerbestand ComM.h bereitgesteld voor softwarecomponenten en BSW-modules [SWS_ComM_00674].

Waardebereik en subtoestanden

Het waardebereik omvat vijf vastgelegde waarden die de exacte fase van de communicatie-state-machine weerspiegelen [SWS_ComM_00674]:

• COMM_NO_COM_NO_PENDING_REQUEST (waarde 0): Duidt de toestand binnen No Communication aan wanneer er momenteel geen communicatieverzoek is [SWS_ComM_00674].
• COMM_NO_COM_REQUEST_PENDING (waarde 1): Duidt de toestand binnen No Communication aan terwijl een verzoek om communicatie in behandeling is [SWS_ComM_00674].
• COMM_FULL_COM_NETWORK_REQUESTED (waarde 2): Duidt de toestand binnen Full Communication aan waarbij het netwerk actief is aangevraagd [SWS_ComM_00674].
• COMM_FULL_COM_READY_SLEEP (waarde 3): Duidt de toestand binnen Full Communication aan waarin er geen actieve verzoeken meer zijn en het netwerk gereed is om te gaan slapen [SWS_ComM_00674].
• COMM_SILENT_COM (waarde 4): Komt overeen met de communicatiemodus Silent Communication [SWS_ComM_00674].

Toewijzing aan de communicatiemodi

De waarden van ComM_StateType staan in een directe relatie tot de bovenliggende communicatiemodi (Communication Modes) van de ComM [SWS_ComM_00674]. Alle toestanden met het voorvoegsel COMM_NO_COM* zijn toegewezen aan de modus No Communication, terwijl toestanden met het voorvoegsel COMM_FULL_COM* overeenkomen met de modus Full Communication [SWS_ComM_00674]. De waarde COMM_SILENT_COM geeft de gelijknamige communicatiemodus Silent Communication weer [SWS_ComM_00674].

Het datatype ComM_ModeType geeft de actuele communicatiemodus en daarmee de primaire toestand van de ComM-kanaaltoestandsmachine in de Communication Manager weer [SWS_ComM_00672]. Het is afgeleid van het basistype uint8 en wordt via de header Rte_ComM_Type.h beschikbaar gesteld voor gebruik door softwarecomponenten en andere BSW-modules [SWS_ComM_00672].

Het waardebereik omvat vier discrete bedrijfsmodi die de communicatiemogelijkheden van het desbetreffende kanaal definiëren [SWS_ComM_00672]:

• COMM_NO_COMMUNICATION (0): Het geconfigureerde kanaal bevindt zich in de rusttoestand en beschikt noch over zend- noch over ontvangstmogelijkheden [SWS_ComM_00672].
• COMM_SILENT_COMMUNICATION (1): Het kanaal is beperkt tot passieve ontvangstmogelijkheden; het uitzenden van berichten is geblokkeerd [SWS_ComM_00672].
• COMM_FULL_COMMUNICATION (2): Het kanaal bevindt zich in volledig communicatiebedrijf met actieve zend- en ontvangstmogelijkheden [SWS_ComM_00672].
• COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST (3): Het kanaal beschikt over zend- en ontvangstmogelijkheden naar de onderste laag, bijvoorbeeld voor Ethernet-hardware conform OPEN Alliance TC10 [SWS_ComM_00672].

Bij het gebruik gelden belangrijke functionele beperkingen: De modus COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST is voorzien van de tag atp.Status=draft en uitdrukkelijk bestemd voor zuiver intern gebruik binnen de ComM-kanaaltoestandsmachine [SWS_ComM_00672]. Externe gebruikers of bovenliggende softwarecomponenten mogen deze toestand daarom vermoedelijk noch als doelmodus aanvragen noch via interfaces direct verwachten. Vraag Q-e5f4abe0d6543c82 (open) Specifieke foutcodes, runtime-controles of meldingen aan DET of DEM zijn voor dit type niet gedefinieerd [SWS_ComM_00672].

Het specificatie-element modeLimitation is conform [SWS_ComM_01009] gedefinieerd als een geleverde poort (Provided Port) van de communicatiemanager (ComM) voor de interface ComM_ECUModeLimitation. Interpretatie: Via deze poort-interface zou de module ComM aan bovenliggende softwarecomponenten of de BswM mechanismen beschikbaar moeten stellen voor de gerichte begrenzing van de actieve communicatiemodi op ECU-niveau, om bijvoorbeeld het stroomverbruik of bedrijfsmodi te beveiligen. Vraag Q-337c6b40bd72cf76 (open)

De beschikbaarstelling van deze poort in het systeem is onderworpen aan een expliciete variantievoorwaarde: Volgens [SWS_ComM_01009] is het element uitsluitend in het systeem aanwezig wanneer de configuratieoptie {ecuc(ComM/ComMGeneral.ComMModeLimitationEnabled)} == true is ingesteld. Vermoedelijk leidt het deactiveren van deze parameter ertoe dat de poort tijdens de codegeneratie vervalt. Vraag (open) Applicatie- en basissoftwarecomponenten mogen deze interface daarom alleen bij geactiveerde optie architectonisch koppelen.

Wat betreft concrete interface-operaties, parameters, re-entrantie en foutmeldingen aan DET of DEM bevat [SWS_ComM_01009] geen afzonderlijke bepalingen. Integrators moeten er daarom vooral voor zorgen dat de vereiste configuratie in de container ComMGeneral is geactiveerd voordat componenten met de poort modeLimitation worden verbonden.

Het type ComMMode is in de module ComM gespecificeerd als Mode Declaration Group [SWS_ComM_01012]. Het element is toegewezen aan de categorie ALPHABETIC_ORDER en definieert de fundamentele communicatiemodi van de module [SWS_ComM_01012].

De groep omvat drie bindende toestanden [SWS_ComM_01012]:

• COMM_NO_COMMUNICATION: Dient als initiële modus van de groep [SWS_ComM_01012].
• COMM_SILENT_COMMUNICATION: Vertegenwoordigt een passieve communicatiemodus [SWS_ComM_01012].
• COMM_FULL_COMMUNICATION: Markeert het onbeperkte communicatiebedrijf [SWS_ComM_01012].

Als initiële modus is COMM_NO_COMMUNICATION vastgelegd, waarmee het systeem standaard zonder actieve communicatie start [SWS_ComM_01012]. Voor overgangen is geen afzonderlijke waarde („On transition value”) gedefinieerd [SWS_ComM_01012]; Interpretatie: Dit betekent vermoedelijk dat statuswisselingen direct zonder gedefinieerde tussentoestanden worden voltrokken. Vraag Q-f0e73d26f85073b4 (open) Interpretatie: De modi zouden de communicatietoestand van kanalen of communicatiegebruikers in de module moeten weerspiegelen. Vraag Q-ef5fa29f6af152c7 (open) Interpretatie: De categorie ALPHABETIC_ORDER zou vooral de gestandaardiseerde opsomming en representatie voor de interfaces van de RTE moeten voorschrijven. Vraag Q-12af3dde3a4cc95e (open)