Als ara::com-Dienst modellierte Schnittstelle; Methoden/Felder werden über generierte Proxies/Skeletons aufgerufen (Parameterrichtung IN/OUT).
User GuideKI-GENERIERT
Dient der Übertragung, Verarbeitung, Aktivierung und Überwachung von Softwarepaketen und Software-Clustern im UCM.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 6e0698182e67HerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Dient der Übertragung, Verarbeitung, Aktivierung und Überwachung von Softwarepaketen und Software-Clustern im UCM.
Das Service-Interface PackageManagement steuert die Übertragung, Verarbeitung und Aktivierung von Softwarepaketen auf der AUTOSAR Adaptive Platform [SWS_UCM_00345], [SWS_UCM_00352]. Es ermöglicht das blockweise Laden von Paketen, die Extraktion von Software-Clustern sowie deren kontrollierte Aktivierung in Abstimmung mit dem State Management [SWS_UCM_00346], [SWS_UCM_00352]. Zudem stellt der Service Mechanismen zur Statusüberwachung sowie zum Rollback und Bereinigen von Sitzungsdaten bereit [SWS_UCM_00353], [SWS_UCM_00361].
1. Rolle und Systemkontext der Service-Schnittstelle
Das Service-Interface PackageManagement bildet die zentrale Schnittstelle des Update and Configuration Management (UCM) zur Verwaltung, Übertragung und Installation von Softwarepaketen auf der AUTOSAR Adaptive Platform [SWS_UCM_00343]. Die UCM-Instanz fungiert hierbei typischerweise als Service-Provider (Skeleton), während übergeordnete Update-Koordinatoren oder Diagnose-Clients als Service-Consumer (Proxy) agieren. Für die Identifikation stellt der Service über die Methode GetId den eindeutigen Modulinstanz-Identifikator bereit [SWS_UCM_00343]. Während des Aktivierungsvorgangs interagiert UCM eng mit dem State Management, welches die Update-Sitzung freigeben und Verifikationen durchführen muss [SWS_UCM_00352].
2. Methoden, Ereignisse und Felder
Alle im Service-Interface definierten Methoden arbeiten mit synchroner Aufrufsemantik bzw. mit Request-Response-Meldungen, da für sämtliche Methoden Fire & Forget false spezifiziert ist [SWS_UCM_00345]. Das Zustandsfeld CurrentStatus besitzt einen Getter sowie einen Notifier, wodurch Clients Statusänderungen des UCM ereignisgesteuert abonnieren oder aktiv abfragen können [SWS_UCM_00361]. Ergänzend liefert GetProgress detaillierte Fortschrittsinformationen zum jeweils aktiven Zustand der Zustandsmaschine [SWS_UCM_00360]. Für Abfragen des Softwarebestands stehen GetSwPackages zur Auflistung verfügbarer Softwarepakete [SWS_UCM_00359], GetSwClusterInfo für installierte Software-Cluster im Zustand kPresent[SWS_UCM_00357], GetSwClusterManifestInfo für Cluster-Manifestdaten [SWS_UCM_00358] sowie GetSwClusterChangeInfo für anstehende Änderungen in den Zuständen kAdded, kUpdating oder kRemoved zur Verfügung [SWS_UCM_00356]. Die historische Nachvollziehbarkeit ausgeführter Aktionen wird über GetHistory mit Zeitstempelfiltern bereitgestellt [SWS_UCM_00355].
3. Lebenszyklus, Sitzungsabläufe und Zustandsabhängigkeiten
Ein typischer Update-Ablauf gliedert sich in Transfer, Verarbeitung, Aktivierung und Abschluss. Die Paketübertragung wird entweder durch TransferStart eingeleitet, wodurch eine TransferIdType erzeugt und die Blockgröße ausgehandelt wird [SWS_UCM_00345], oder alternativ durch RegisterSoftwarePackage unter Angabe einer Paket-URI registriert [SWS_UCM_00344]. Bei blockweiser Übertragung werden die Datenblöcke fortlaufend über TransferData unter Angabe eines Blockzählers persistiert [SWS_UCM_00346] und mit TransferExit finalisiert [SWS_UCM_00347]. Anschließend extrahiert ProcessSwPackage das Softwarepaket [SWS_UCM_00349]. Laufende Verarbeitungen können mittels Cancel abgebrochen [SWS_UCM_00351] oder mit Suspend und Resume unterbrochen bzw. wiederaufgenommen werden [SWS_UCM_00397], [SWS_UCM_00398]. Nicht mehr benötigte Transfers lassen sich mit DeleteTransfer entfernen [SWS_UCM_00348]. Mit Activate werden die extrahierten Software-Cluster aktiviert [SWS_UCM_00352], während Finish die Verarbeitungssitzung beendet und temporäre Daten bereinigt [SWS_UCM_00354]. Treten Fehler auf, erlauben RevertProcessedSwPackages ein Zurücksetzen verarbeiteter Pakete [SWS_UCM_00350] sowie Rollback die Wiederherstellung des Systemzustands vor der Paketverarbeitung [SWS_UCM_00353].
Die Schnittstellenmethoden sichern Fehlerbedingungen über spezifische Application Errors ab. Bei kontextwidrigen Aufrufen geben Methoden wie Activate, Cancel, Finish, ProcessSwPackage, TransferData und TransferExit den Fehler kOperationNotPermitted zurück [SWS_UCM_00346], [SWS_UCM_00347], [SWS_UCM_00349], [SWS_UCM_00352]. Ungültige Transfer-IDs werden mit kTransferIdInvalid abgewiesen [SWS_UCM_00346], [SWS_UCM_00348], während fehlerhafte Blockfolgen oder Speicherengpässe zu kBlockIncorrect, kBlockSizeIncorrect, kBlockInconsistent oder kMemoryInsufficient führen [SWS_UCM_00345], [SWS_UCM_00346]. Sicherheits- und Konsistenzprüfungen werfen Fehler wie kAuthenticationFailed, kPackageInconsistent, kPackageManifestInvalid sowie kPackageVersionIncompatible[SWS_UCM_00346], [SWS_UCM_00349]. Die Entfernung des Kernsystems wird mit kSwclRemovalDenied unterbunden [SWS_UCM_00349]. Bei der Aktivierung signalisieren kDependencyMissing, kUpdateSessionRejected oder kVerificationFailed Integrationsprobleme mit Abhängigkeiten oder dem State Management [SWS_UCM_00352].
Dieser Leitfaden wurde durch eine KI auf Basis der AUTOSAR-Spezifikation R25-11 generiert.
Mitglieder
ActivateThis method activates the Software Clusters extracted from the processed Software Packages.
CancelThis method aborts an ongoing processing of a Software Package.
This method finishes the processing for the current set of processed Software Packages. It does a cleanup of all data of the processing including the sources of the Software Packages.
This method returns a list pending changes to the set of SoftwareClusters on the adaptive platform. The returned list includes all SoftwareClusters that are to be added, updated or removed. The list of changes is extended in the course of processing Software Packages.
Start the transfer of a Software Package after having received a Vehicle Package. The size of the Software Package to be transferred to UCM must be provided. UCM will generate a Transfer ID for subsequent calls to TransferData, TransferExit, ProcessSwPackage, DeleteTransfer.
This method aborts an ongoing processing of a Software Package.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: b042c91a5838HerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Verwendung
Die Servicemethode Cancel der Serviceschnittstelle PackageManagement dient dazu, die laufende Verarbeitung eines Software-Pakets vorzeitig abzubrechen [SWS_UCM_00351]. Als Aufrufparameter wird die Kennung des Vorgangs als IN-Parameter id vom Typ TransferIdType übergeben [SWS_UCM_00351]. Da Fire & Forget für diese Methode auf false gesetzt ist, erfolgt der Methodenaufruf synchron mit Bestätigung bzw. Rückmeldung an den Aufrufer [SWS_UCM_00351].
Fehlerbehandlung
Schlägt die Ausführung fehl, definiert die Schnittstelle spezifische Fehlercodes (Application Errors) [SWS_UCM_00351]:
kTransferIdInvalid: Die übermittelte Transfer-ID ist ungültig [SWS_UCM_00351].
kOperationNotPermitted: Der Abbruch wird im gegenwärtigen Kontext nicht unterstützt [SWS_UCM_00351].
Zusammenspiel und Nebenläufigkeit
Die Methode steht in engem Zusammenhang mit der Paketverarbeitung: Ein Verarbeitungsvorgang wird typischerweise über ProcessSwPackage für eine zugewiesene TransferIdType id initiiert [SWS_UCM_00349]. Interpretation: Cancel dürfte primär darauf ausgelegt sein, die durch ProcessSwPackage laufende Paketverarbeitung abzubrechen [SWS_UCM_00349], [SWS_UCM_00351]. Frage Q-a220345676f7046c (offen) Aufrufer müssen sicherstellen, dass die Transfer-ID existiert und sich das Paket in einem Zustand befindet, der einen Abbruch zulässt, um den Fehler kOperationNotPermitted zu vermeiden [SWS_UCM_00351].
Dieser Text wurde von einer KI generiert und dient als Orientierungshilfe.
This method finishes the processing for the current set of processed Software Packages. It does a cleanup of all data of the processing including the sources of the Software Packages.
service method GetSwClusterChangeInfo [SWS_UCM_00356]Upstream: RS_UCM_00011 Wortlaut noch nicht übernommen, RS_UCM_00018 Wortlaut noch nicht übernommen
This method returns a list pending changes to the set of SoftwareClusters on the adaptive platform. The returned list includes all SoftwareClusters that are to be added, updated or removed. The list of changes is extended in the course of processing Software Packages.
service method ProcessSwPackage [SWS_UCM_00349]Upstream: RS_UCM_00005, RS_UCM_00015 Wortlaut noch nicht übernommen, RS_UCM_00026 Wortlaut noch nicht übernommen
service method RegisterSoftwarePackage [SWS_UCM_00344]Upstream: RS_UCM_00019 Wortlaut noch nicht übernommen, RS_UCM_00025 Wortlaut noch nicht übernommen
registers a package that could already be in Machine’s file system or to be downloaded.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 0620dbe84c7eHerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Verwendung
Die Servicemethode RegisterSoftwarePackage gehört zum Service-Interface PackageManagement (Version 1.0) und dient dazu, ein Software-Paket im System zu registrieren [SWS_UCM_00344]. Das Zielpaket kann sich dabei bereits lokal im Dateisystem der Maschine befinden oder als Referenz für einen ausstehenden Download übergeben werden.
Die Methode besitzt folgende Parameter:
uri (IN, UriString): Gibt den URI-Pfad an, der auf das zu registrierende Software-Paket verweist [SWS_UCM_00344].
transferId (OUT, TransferIdType): Liefert nach erfolgreicher Registrierung eine eindeutige Kennung für den Transfervorgang zurück [SWS_UCM_00344].
Aufrufsemantik und Fehlerbehandlung
Die Eigenschaft Fire & Forget ist für diesen Dienst auf false gesetzt [SWS_UCM_00344]. Aufrufer erhalten daher eine direkte Quittierung über das Ergebnis der Methodenabarbeitung. Ist die übergebene URI syntaktisch ungültig oder verweist auf ein unzulässiges Ziel, schlägt die Ausführung mit dem spezifischen Anwendungsfehler kInvalidUri fehl [SWS_UCM_00344].
Zusammenspiel und Einschränkungen
Der Methodenaufruf bildet typischerweise den initialen Schritt im Ablauf der Paketverwaltung. Die zurückgegebene transferId dürfte als Interpretation in weiteren Schritten des Paketmanagements verwendet werden, um den Übertragungs- oder Installationsprozess eindeutig zu adressieren. Frage Q-fc2bc07c914858a2 (offen) Da keine Nebenläufigkeitszusagen spezifiziert sind, sollte der Aufrufer das Eintreffen des Ergebnisses abwarten, bevor Folgeaktionen mit der betreffenden Kennung eingeleitet werden.
Dieser Verwendungshinweis wurde von einer KI auf Basis der Spezifikation AUTOSAR Adaptive R25-11 generiert.
service method TransferData [SWS_UCM_00346]Upstream: RS_UCM_00019 Wortlaut noch nicht übernommen, RS_UCM_00025 Wortlaut noch nicht übernommen
TransferData (IN TransferIdType id, IN ByteVectorType Management data, IN uint64_t blockCounter)
Block-wise transfer of a Software Package to UCM.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: fbad4e8e0243HerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Die Servicemethode TransferData dient der blockweisen Übertragung eines Softwarepakets an den Update and Configuration Management Manager (UCM) innerhalb des Service-Interfaces PackageManagement ([SWS_UCM_00346]). Da die Methode nicht als Fire & Forget definiert ist, liefert jeder Aufruf eine Bestätigung oder einen spezifischen Anwendungsfehler zurück.
Für den Aufruf müssen folgende Eingangsparameter übergeben werden ([SWS_UCM_00346]):
id (TransferIdType): Die zuvor durch den UCM erzeugte Transfer-Identifikation.
data (ByteVectorType Management): Der zu übertragende Nutzdatenblock des Softwarepakets.
blockCounter (uint64_t): Der fortlaufende Zähler des aktuellen Datenblocks.
Hinsichtlich Reihenfolge und Zusammenspiel setzt die Methode einen vorherigen Aufruf von TransferStart voraus ([SWS_UCM_00345]). Über TransferStart erhält der Aufrufer neben der gültigen Transfer-ID auch die geforderte Blockgröße blockSize sowie die Verpflichtung zur Angabe der Gesamtpaketgröße. Die Datenübertragung muss sich strikt an diese Vorgaben halten; Interpretation: Der blockCounter dürfte vom Aufrufer monoton und lückenlos inkrementiert werden müssen, da ein doppelter Empfang derselben Blocknummer den Fehler kBlockIncorrect auslöst ([SWS_UCM_00346]). Frage Q-61272c50c151f4db (offen)
Die Fehlerbehandlung differenziert zwischen strukturellen Übertragungsfehlern, Konsistenzproblemen und Paketvalidierungsfehlern ([SWS_UCM_00346]):
Übertragung und Ressourcen: Ist die Sitzung ungültig oder der Aufrufkontext falsch, antwortet UCM mit kTransferIdInvalid oder kOperationNotPermitted. Überschreitet ein Block die vereinbarte Größe oder die angekündigte Gesamtgröße, folgen kBlockSizeIncorrect bzw. kSizeIncorrect. Bei unzureichendem Speicher oder Fehlern beim Persistieren werden kMemoryInsufficient oder kTransferFailed zurückgegeben.
Integrität und Kompatibilität: Schlagen Prüfungen der Daten fehl, werden kBlockInconsistent, kPackageInconsistent oder kAuthenticationFailed gemeldet. Zudem werden ungültige Manifeste (kPackageManifestInvalid), inkompatible Versionen (kPackageVersionIncompatible, kOldVersion), nicht unterstützte Formate (kPackageFormatUnsupported) oder das unzulässige Entfernen von Core-Clustern (kSwclRemovalDenied) abgewiesen.
Dieser Nutzungshinweis wurde automatisiert auf Basis der AUTOSAR-Spezifikation R25-11 generiert.
Start the transfer of a Software Package after having received a Vehicle Package. The size of the Software Package to be transferred to UCM must be provided. UCM will generate a Transfer ID for subsequent calls to TransferData, TransferExit, ProcessSwPackage, DeleteTransfer.
gemini-3.8-flash-medium· 2026-10-13