Figure 7.8: Communication Group Template

1. Diagrammtyp & Architektur-Kontext

• Diagrammtyp: ARXML-Instanziierungsbeispiel / Datenmodell-Ausschnitt (AUTOSAR M1-Modell-Template).
• Architektur-Kontext: AUTOSAR Adaptive Platform (AP), Spezifikation SWS Communication Management (ara::com), Release R20-11.
• Technischer Zweck: Definition des standardisierten ARXML-Metamodell-Templates für Communication Groups (COMMUNICATION_GROUP) gemäß [RS_CM_00600] und [SWS_CM_99000]. Es spezifiziert das formale Mapping eines 1:N-Gruppenkommunikationsmusters (Multicast-Broadcast mit asynchronem N:1-Feedbackkanal) auf das generische ServiceInterface-Metamodell, primär eingesetzt für koordinierende Plattformdienste wie das State Management (ara::sm).

2. Komponenten, Entitäten & Schnittstellen

• Root-Entität: <SERVICE-INTERFACE>
  • SHORT-NAME: PowerMode – Definiert den logischen Namen der Communication Group.
  • CATEGORY: COMMUNICATION_GROUP – Normativer Kategorie-Stereotyp zur Steuerung der Codegeneratoren für spezialisierte Gruppen-APIs.
  • NAMESPACES: C++-Namespace-Hierarchie via verschachtelte SYMBOL-PROPS (ara → sm), resultierend im C++ Scope ara::sm.
• Methoden-Entität (Downlink / Command):
  • <METHODS> → <CLIENT-SERVER-OPERATION> mit festem Bezeichner SHORT-NAME: message [SWS_CM_99007].
  • Enthält genau ein <ARGUMENT-DATA-PROTOTYPE> mit SHORT-NAME: msg und DIRECTION: IN.
  • Typbindung: <TYPE-TREF DEST="STD-CPP-IMPLEMENTATION-DATA-TYPE"> referenziert den Datentyp der Gruppennachricht (/AUTOSAR/StateM/Imp/PowerModeMsg).
• Event-Entität (Uplink / Feedback):
  • <EVENTS> → <VARIABLE-DATA-PROTOTYPE> mit festem Bezeichner SHORT-NAME: response [SWS_CM_99007].
  • Typbindung: <TYPE-TREF DEST="STD-CPP-IMPLEMENTATION-DATA-TYPE"> referenziert den Rückmelde-Datentyp der Gruppenmitglieder (/AUTOSAR/StateM/Imp/PowerModeRespMsg).
• Strukturelle Kardinalitäten & Integritätsregeln:
  • Exakt 1 Methoden-Prototyp (message) mit genau 1 IN-Parameter. Keine OUT- oder RETURN-Parameter.
  • Exakt 1 Event-Prototyp (response).

3. Dynamisches Verhalten & Sequenzablauf

Das Diagramm bildet die statische Deklaration für ein asymmetrisches, entkoppeltes Interaktionsmuster ab:

1. Trigger (1:N Downlink): Der Gruppenkoordinator (z. B. State Manager) initiiert eine Aktion durch Aufruf der Operation message(msg).
2. Dispatch & Transport: Das Underlying-Binding (z. B. SOME/IP oder Shared Memory/IPC) verteilt die Nachricht per Multicast/Broadcast an alle an der Communication Group teilnehmenden Prozesse/Applikationen.
3. Ausführung: Teilnehmerprozesse empfangen die Nachricht, führen Zustandswechsel oder Vorbereitungen lokal durch (z. B. Vorbereitung auf Suspend/Shutdown).
4. Asynchroner Rückkanal (N:1 Uplink): Jeder Teilnehmer sendet nach Vollzug seiner lokalen Operation eine Antwortmeldung über das Event response.
5. Aggregation: Der Koordinator aggregiert die eingehenden response-Events, überwacht lokale Timeouts und schließt die Gesamttransaktion ab, sobald alle Gruppenmitglieder geantwortet haben oder ein Fehler auftritt.

4. Normative Relevanz & Entwickler-Hinweise

• Restriktive Namenskonventionen ([SWS_CM_99000], [SWS_CM_99007]):
  • Bezeichner für Operation (message), Argument (msg), Event (response) sowie die Metamodell-Kategorie (COMMUNICATION_GROUP) sind normativ vorgegeben. Modell-Checker und Generatoren verwerfen abweichende Namen als Schema-Verletzung.
• Kein RPC-Semantikvertrag:
  • Die Methode message darf in der generierten API nicht blockierend auf Client-Server-Rückgabewerte warten. Sie besitzt Fire-and-Forget-Charakter.
• Korrelation auf Nutzdaten-Ebene:
  • Da das Middleware-Transportprotokoll keine automatische Ende-zu-Ende-Korrelation zwischen der gesendeten message und den asynchron eintreffenden response-Events erzwingt, müssen Entwickler Transaktions- oder Sequenz-IDs in den Payloads (PowerModeMsg bzw. PowerModeRespMsg) implementieren.
• Code-Generator & Binding-Verhalten ([SWS_CM_99020] ff.):
  • Generatoren erzeugen keine Standard-Client/Server-Proxies, sondern spezifische Sender-/Receiver-Strukturen, die Multicast-fähige Transportmechanismen im Deployment konfigurieren.