Figure 11.4: Sequence diagram showing the package processing

1. Diagrammtyp & Architektur-Kontext

• Diagrammtyp: UML-Sequenzdiagramm mit kombinierten Fragmenten (opt, loop).
• Architektur-Kontext: AUTOSAR Adaptive Platform (UCM – Update and Configuration Management nach AUTOSAR_SWS_UpdateAndConfigurationManagement, R21-11/R22-11).
• Funktionaler Zweck: Modellierung des Protokollablaufs zur Verarbeitung empfangener Software-Pakete (Software Package Processing) über die UCM-Dienstschnittstelle PackageManagement. Es visualisiert den Zustandsübergang von IDLE über PROCESSING zu READY sowie die Fortschrittsüberwachung für inkrementell oder parallel übertragene Pakete (TransferId).

2. Komponenten, Entitäten & Schnittstellen

• Akteure & Instanzen:
  • UCM Client: Generischer Service-Consumer (Applikationsebene, z. B. State Management, OTA-Client oder Diagnose-Tester), der die UCM-Dienstschnittstelle ansteuert.
  • «ServiceProvider» :PackageManagement: Server-Instanz des UCM, die das Service Interface ara::ucm::pkgmgr::PackageManagement über ara::com bereitstellt.
• Service-Elemente & Methoden:
  • CurrentStatus: Service-Field/Event zur Übertragung des aggregierten UCM-Lebenszyklusstatus (PackageManagementStatusType: IDLE, PROCESSING, READY).
  • GetSwPackages(): Synchrone Read-Methode, Rückgabe SwPackageInfoVectorType (Metadaten über im UCM vorhandene/übertragene Software-Pakete).
  • ProcessSwPackage(TransferId): Asynchrone Anforderung zur Validierung, Dekompression und Vorbereitung des Software-Pakets. Rückgabetyp: ProcessSwPackageReturnType.
  • GetProgress(TransferIdType): Methode zur Abfrage des Verarbeitungsfortschritts für die angegebene Transfer-ID. Rückgabetyp: char (Übermittlung von :progressInformation).
• Datenstrukturen & Typen:
  • TransferId / TransferIdType: Typisierter Bezeichner des Software-Pakets.
  • char / :progressInformation: Formatierte Fortschrittsinformation zur laufenden Paketverarbeitung.
  • SwPackageInfoVectorType: Liste/Vektor serialisierter Metadatenstrukturen vorhandener Pakete.
  • ProcessSwPackageReturnType: Spezifisches UCM-Fehler-/Ergebnis-Enum bzw. ara::core::Result<void>.

3. Dynamisches Verhalten & Sequenzablauf

1. Initialisierung & Status-Abonnement:
   • Der UCM Client abonniert Statusänderungen via Subscribe(CurrentStatus).
   • UCM bestätigt den Initialzustand CurrentStatus = IDLE.
2. Paket-Enumeration (opt):
   • Optional ruft der UCM Client GetSwPackages() ab, um Metadaten der übertragenen Pakete zu prüfen.
   • UCM antwortet synchron mit SwPackageInfoVectorType.
3. Verarbeitungsschleife (loop for each TransferId):
   • Für jede TransferId ruft der Client ProcessSwPackage(TransferId) auf.
   • Zustandswechsel: UCM wechselt in den Zustand CurrentStatus = PROCESSING.
   • Fortschrittsabfrage (opt continously): Während der Hintergrundverarbeitung fragt der Client zyklisch GetProgress(TransferIdType) ab und erhält die Information :progressInformation (Typ char).
   • UCM bestätigt den Abschluss der Paketverarbeitung asynchron über :ProcessSwPackageReturnType.
4. Abschluss & Folgezustand:
   • Nach Abarbeitung aller relevanten Transfer-IDs wechselt UCM in den Zustand CurrentStatus = READY, womit die Pakete bereit zur Aktivierung sind.

4. Normative Relevanz & Entwickler-Hinweise

• Normative Schnittstellenänderung bei der Fortschrittsabfrage: Die Methode GetSwProcessProgress wurde durch GetProgress ersetzt. Der Parameter ist nun als TransferIdType typisiert; der Rückgabetyp wurde von uint8 auf char bzw. :progressInformation umgestellt.
• Generalisierung der Client-Rolle: Durch den Wechsel von Diagnostic Application (OEM specific) zu UCM Client wird normativ betont, dass der Konsument ein beliebiger interner oder externer Software-Update-Client (z. B. State Management, OTA-Client, Tester) sein kann.
• Zustandskonsistenz: Die normative Zustandsmaschine (IDLE -> PROCESSING -> READY) bleibt intakt; der Client muss CurrentStatus überwachen, um den Gesamtfortschritt und die Aktivierungsbereitschaft zu ermitteln.