Als ara::com-Dienst modellierte Schnittstelle; Methoden/Felder werden über generierte Proxies/Skeletons aufgerufen (Parameterrichtung IN/OUT).
User GuideAI-GEGENEREERD
Dient voor de overdracht, verwerking, activering en bewaking van softwarepakketten en softwareclusters in UCM.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 6e0698182e67HerkomstOpen vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
Dient voor de overdracht, verwerking, activering en bewaking van softwarepakketten en softwareclusters in UCM.
De service-interface PackageManagement bestuurt de overdracht, verwerking en activering van softwarepakketten op het AUTOSAR Adaptive Platform [SWS_UCM_00345], [SWS_UCM_00352]. Deze maakt het bloksgewijs laden van pakketten, het extraheren van softwareclusters en de gecontroleerde activering daarvan in afstemming met het State Management mogelijk [SWS_UCM_00346], [SWS_UCM_00352]. Daarnaast stelt de service mechanismen beschikbaar voor statusbewaking en voor het terugdraaien en opschonen van sessiegegevens [SWS_UCM_00353], [SWS_UCM_00361].
1. Rol en systeemcontext van de service-interface
De service-interface PackageManagement vormt de centrale interface van Update and Configuration Management (UCM) voor het beheren, overdragen en installeren van softwarepakketten op het AUTOSAR Adaptive Platform [SWS_UCM_00343]. De UCM-instantie fungeert hierbij doorgaans als serviceprovider (skeleton), terwijl bovenliggende updatecoördinatoren of diagnoseclients optreden als serviceconsument (proxy). Voor identificatie levert de service via de methode GetId de unieke module-instantie-identifier [SWS_UCM_00343]. Tijdens het activeringsproces interacteert UCM nauw met State Management, dat de updatesessie moet vrijgeven en verificaties moet uitvoeren [SWS_UCM_00352].
2. Methoden, gebeurtenissen en velden
Alle methoden die in de service-interface zijn gedefinieerd, werken met synchrone aanroepsemantiek c.q. met request-response-berichten, aangezien voor alle methoden Fire & Forget false is gespecificeerd [SWS_UCM_00345]. Het toestandsveld CurrentStatus beschikt over een getter en een notifier, waardoor clients toestandswijzigingen van het UCM event-gestuurd kunnen abonneren of actief kunnen opvragen [SWS_UCM_00361]. Aanvullend levert GetProgress gedetailleerde voortgangsinformatie over de actieve toestand van de toestandsmachine [SWS_UCM_00360]. Voor het opvragen van het softwarebestand zijn GetSwPackages beschikbaar voor een lijst van beschikbare softwarepakketten [SWS_UCM_00359], GetSwClusterInfo voor geïnstalleerde softwareclusters in de toestand kPresent[SWS_UCM_00357], GetSwClusterManifestInfo voor clustermanifestgegevens [SWS_UCM_00358] en GetSwClusterChangeInfo voor openstaande wijzigingen in de toestanden kAdded, kUpdating of kRemoved[SWS_UCM_00356]. De historische traceerbaarheid van uitgevoerde acties wordt beschikbaar gesteld via GetHistory met tijdstempelfilters [SWS_UCM_00355].
3. Levenscyclus, sessieverlopen en toestandsafhankelijkheden
Een typisch updateverloop is onderverdeeld in overdracht, verwerking, activering en afronding. De pakketoverdracht wordt geïnitieerd door TransferStart, waardoor een TransferIdType wordt aangemaakt en de blokgrootte wordt onderhandeld [SWS_UCM_00345], of alternatief geregistreerd door RegisterSoftwarePackage onder vermelding van een pakket-URI [SWS_UCM_00344]. Bij bloksgewijze overdracht worden de datablokken continu gepersisteerd via TransferData onder opgave van een blokteller [SWS_UCM_00346] en afgerond met TransferExit[SWS_UCM_00347]. Vervolgens extraheert ProcessSwPackage het softwarepakket [SWS_UCM_00349]. Lopend verwerkingswerk kan worden afgebroken via Cancel[SWS_UCM_00351] of worden onderbroken c.q. hervat met Suspend en Resume[SWS_UCM_00397], [SWS_UCM_00398]. Niet meer benodigde transfers kunnen worden verwijderd met DeleteTransfer[SWS_UCM_00348]. Met Activate worden de geëxtraheerde softwareclusters geactiveerd [SWS_UCM_00352], terwijl Finish de verwerkingssessie beëindigt en tijdelijke gegevens opschoont [SWS_UCM_00354]. Als er fouten optreden, maken RevertProcessedSwPackages het terugdraaien van verwerkte pakketten mogelijk [SWS_UCM_00350] en Rollback het herstellen van de systeemtoestand van vóór de pakketverwerking [SWS_UCM_00353].
De interfacemethoden vangen foutcondities af via specifieke Application Errors. Bij aanroepen die strijdig zijn met de context retourneren methoden zoals Activate, Cancel, Finish, ProcessSwPackage, TransferData en TransferExit de fout kOperationNotPermitted[SWS_UCM_00346], [SWS_UCM_00347], [SWS_UCM_00349], [SWS_UCM_00352]. Ongeldige transfer-ID's worden afgewezen met kTransferIdInvalid[SWS_UCM_00346], [SWS_UCM_00348], terwijl foutieve blokreeksen of geheugentekorten leiden tot kBlockIncorrect, kBlockSizeIncorrect, kBlockInconsistent of kMemoryInsufficient[SWS_UCM_00345], [SWS_UCM_00346]. Beveiligings- en consistentiecontroles genereren fouten zoals kAuthenticationFailed, kPackageInconsistent, kPackageManifestInvalid en kPackageVersionIncompatible[SWS_UCM_00346], [SWS_UCM_00349]. Het verwijderen van het kernsysteem wordt verhinderd met kSwclRemovalDenied[SWS_UCM_00349]. Bij activering signaleren kDependencyMissing, kUpdateSessionRejected of kVerificationFailed integratieproblemen met afhankelijkheden of het State Management [SWS_UCM_00352].
Deze handleiding is gegenereerd door een AI op basis van de AUTOSAR-specificatie R25-11.
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.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: b042c91a5838HerkomstOpen vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
Gebruik
De servicemethode Cancel van de service-interface PackageManagement dient ertoe de lopende verwerking van een softwarepakket voortijdig af te breken [SWS_UCM_00351]. Als aanroepparameter wordt de identificator van de bewerking als IN-parameter id van het type TransferIdType doorgegeven [SWS_UCM_00351]. Aangezien Fire & Forget voor deze methode op false staat, geschiedt de methode-aanroep synchroon met bevestiging resp. terugkoppeling aan de aanroeper [SWS_UCM_00351].
Foutafhandeling
Mislukt de uitvoering, dan definieert de interface specifieke foutcodes (Application Errors) [SWS_UCM_00351]:
kTransferIdInvalid: De verzonden transfer-ID is ongeldig [SWS_UCM_00351].
kOperationNotPermitted: Het afbreken wordt in de huidige context niet ondersteund [SWS_UCM_00351].
Interactie en gelijktijdigheid
De methode staat in nauw verband met de pakketverwerking: Een verwerkingsproces wordt typisch via ProcessSwPackage voor een toegewezen TransferIdType id geïnitieerd [SWS_UCM_00349]. Interpretatie: Cancel is vermoedelijk primair ontworpen om de via ProcessSwPackage lopende pakketverwerking af te breken [SWS_UCM_00349], [SWS_UCM_00351]. Vraag Q-a220345676f7046c (open) Aanroepers moeten ervoor zorgen dat de transfer-ID bestaat en het pakket zich in een toestand bevindt die afbreken toestaat, om de fout kOperationNotPermitted te vermijden [SWS_UCM_00351].
Deze tekst is gegenereerd door een AI en dient als oriëntatiehulp.
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.
service-methode ProcessSwPackage [SWS_UCM_00349]Upstream: RS_UCM_00005, RS_UCM_00015 tekst nog niet geïmporteerd, RS_UCM_00026 tekst nog niet geïmporteerd
registers a package that could already be in Machine’s file system or to be downloaded.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 0620dbe84c7eHerkomstOpen vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
Gebruik
De servicemethode RegisterSoftwarePackage behoort tot de service-interface PackageManagement (versie 1.0) en dient ertoe een softwarepakket in het systeem te registreren [SWS_UCM_00344]. Het doelpakket kan zich daarbij reeds lokaal in het bestandssysteem van de machine bevinden of als referentie voor een openstaande download worden overgedragen.
De methode heeft de volgende parameters:
uri (IN, UriString): Geeft het URI-pad aan dat verwijst naar het te registreren softwarepakket [SWS_UCM_00344].
transferId (OUT, TransferIdType): Levert na succesvolle registratie een unieke identificator voor het overdrachtsproces terug [SWS_UCM_00344].
Aanroepsemantiek en foutafhandeling
De eigenschap Fire & Forget staat voor deze service ingesteld op false[SWS_UCM_00344]. Aanroepers ontvangen daarom een directe bevestiging over het resultaat van de methode-afhandeling. Als de doorgegeven URI syntactisch ongeldig is of naar een ontoelaatbare bestemming verwijst, mislukt de uitvoering met de specifieke applicatiefout kInvalidUri[SWS_UCM_00344].
Interactie en beperkingen
De methode-aanroep vormt doorgaans de initiële stap in het verloop van het pakketbeheer. De geretourneerde transferId wordt als interpretatie vermoedelijk in verdere stappen van het pakketbeheer gebruikt om het overdrachts- of installatieproces eenduidig te adresseren. Vraag Q-fc2bc07c914858a2 (open) Aangezien er geen toezeggingen over gelijktijdigheid zijn gespecificeerd, moet de aanroeper wachten op het resultaat voordat vervolgacties met de desbetreffende identificator worden gestart.
Deze gebruiksinstructie is gegenereerd door een AI op basis van de specificatie AUTOSAR Adaptive R25-11.
service-methode TransferData [SWS_UCM_00346]Upstream: RS_UCM_00019 tekst nog niet geïmporteerd, RS_UCM_00025 tekst nog niet geïmporteerd
TransferData (IN TransferIdType id, IN ByteVectorType Management data, IN uint64_t blockCounter)
Block-wise transfer of a Software Package to UCM.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: fbad4e8e0243HerkomstOpen vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
De servicemethode TransferData dient voor de bloksgewijze overdracht van een softwarepakket aan de Update and Configuration Management Manager (UCM) binnen de service-interface PackageManagement ([SWS_UCM_00346]). Aangezien de methode niet is gedefinieerd als Fire & Forget, levert elke aanroep een bevestiging of een specifieke applicatiefout op.
Voor de aanroep moeten de volgende ingangsparameters worden doorgegeven ([SWS_UCM_00346]):
id (TransferIdType): De eerder door de UCM gegenereerde transfer-identificatie.
data (ByteVectorType Management): Het over te dragen nuttige datablok van het softwarepakket.
blockCounter (uint64_t): De doorlopende teller van het huidige datablok.
Wat betreft de volgorde en interactie vereist de methode een voorafgaande aanroep van TransferStart ([SWS_UCM_00345]). Via TransferStart ontvangt de aanroeper naast de geldige transfer-ID ook de vereiste blokgrootte blockSize evenals de verplichting tot het opgeven van de totale pakketgrootte. De gegevensoverdracht moet zich strikt houden aan deze richtlijnen; interpretatie: De blockCounter moet vermoedelijk monotoon en aaneengesloten door de aanroeper worden geïncrementeerd, aangezien een dubbele ontvangst van hetzelfde bloknummer de fout kBlockIncorrect veroorzaakt ([SWS_UCM_00346]). Vraag Q-61272c50c151f4db (open)
De foutafhandeling maakt onderscheid tussen structurele overdrachtsfouten, consistentieproblemen en pakketvalidatiefouten ([SWS_UCM_00346]):
Overdracht en resources: Is de sessie ongeldig of de aanroepcontext onjuist, dan antwoordt UCM met kTransferIdInvalid of kOperationNotPermitted. Overschrijdt een blok de afgesproken grootte of de aangekondigde totale grootte, dan volgen kBlockSizeIncorrect resp. kSizeIncorrect. Bij onvoldoende geheugen of fouten bij het persisteren worden kMemoryInsufficient of kTransferFailed geretourneerd.
Integriteit en compatibiliteit: Mislukken gegevenscontroles, dan worden kBlockInconsistent, kPackageInconsistent of kAuthenticationFailed gemeld. Daarnaast worden ongeldige manifesten (kPackageManifestInvalid), incompatibele versies (kPackageVersionIncompatible, kOldVersion), niet-ondersteunde formaten (kPackageFormatUnsupported) of het ontoelaatbare verwijderen van core-clusters (kSwclRemovalDenied) geweigerd.
Deze gebruiksinstructie is geautomatiseerd gegenereerd op basis van de AUTOSAR-specificatie R25-11.
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-low· 2026-10-13 · Duits origineel