Als ara::com-Dienst modellierte Schnittstelle; Methoden/Felder werden über generierte Proxies/Skeletons aufgerufen (Parameterrichtung IN/OUT).
Guia do utilizadorGERADO POR IA
Serve para a transferência, o processamento, a ativação e o monitoramento de pacotes de software e clusters de software no UCM.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 6e0698182e67ProcedênciaPerguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
Serve para a transferência, o processamento, a ativação e o monitoramento de pacotes de software e clusters de software no UCM.
A interface de serviço PackageManagement controla a transferência, o processamento e a ativação de pacotes de software na AUTOSAR Adaptive Platform [SWS_UCM_00345], [SWS_UCM_00352]. Ela permite o carregamento em blocos de pacotes, a extração de clusters de software e sua ativação controlada em coordenação com o State Management [SWS_UCM_00346], [SWS_UCM_00352]. Além disso, o serviço disponibiliza mecanismos para monitoramento de status, bem como para rollback e limpeza de dados de sessão [SWS_UCM_00353], [SWS_UCM_00361].
1. Papel e contexto de sistema da interface de serviço
O Service-Interface PackageManagement constitui a interface central do Update and Configuration Management (UCM) para gerenciamento, transferência e instalação de pacotes de software na AUTOSAR Adaptive Platform [SWS_UCM_00343]. A instância do UCM atua tipicamente como provedor de serviço (Skeleton), enquanto coordenadores de atualização ou clientes de diagnóstico de nível superior operam como consumidores de serviço (Proxy). Para identificação, o serviço fornece o identificador unívoco de instância de módulo por meio do método GetId[SWS_UCM_00343]. Durante o processo de ativação, o UCM interage estreitamente com o State Management, que deve liberar a sessão de atualização e executar verificações [SWS_UCM_00352].
2. Métodos, eventos e campos
Todos os métodos definidos na interface de serviço operam com semântica de chamada síncrona ou mensagens do tipo solicitação-resposta, uma vez que Fire & Forget false é especificado para todos os métodos [SWS_UCM_00345]. O campo de estado CurrentStatus possui um getter e um notifier, permitindo que os clientes assinem alterações de status do UCM baseadas em eventos ou as consultem ativamente [SWS_UCM_00361]. Adicionalmente, GetProgress fornece informações detalhadas de progresso para o respectivo estado ativo da máquina de estados [SWS_UCM_00360]. Para consultas ao inventário de software, estão disponíveis GetSwPackages para listar pacotes de software disponíveis [SWS_UCM_00359], GetSwClusterInfo para clusters de software instalados no estado kPresent[SWS_UCM_00357], GetSwClusterManifestInfo para dados de manifesto de cluster [SWS_UCM_00358], bem como GetSwClusterChangeInfo para alterações pendentes nos estados kAdded, kUpdating ou kRemoved[SWS_UCM_00356]. A rastreabilidade histórica das ações executadas é disponibilizada por meio de GetHistory com filtros de carimbo de data/hora [SWS_UCM_00355].
3. Ciclo de vida, fluxos de sessão e dependências de estado
Um fluxo típico de atualização divide-se em transferência, processamento, ativação e conclusão. A transferência do pacote é iniciada por TransferStart, gerando um TransferIdType e negociando o tamanho do bloco [SWS_UCM_00345], ou, alternativamente, registrada por RegisterSoftwarePackage mediante a especificação de uma URI de pacote [SWS_UCM_00344]. Na transferência por blocos, os blocos de dados são persistidos continuamente via TransferData com a indicação de um contador de blocos [SWS_UCM_00346] e finalizados com TransferExit[SWS_UCM_00347]. Em seguida, ProcessSwPackage extrai o pacote de software [SWS_UCM_00349]. Processamentos em andamento podem ser cancelados por meio de Cancel[SWS_UCM_00351] ou interrompidos e retomados com Suspend e Resume[SWS_UCM_00397], [SWS_UCM_00398]. Transferências não mais necessárias podem ser removidas com DeleteTransfer[SWS_UCM_00348]. Com Activate, os clusters de software extraídos são ativados [SWS_UCM_00352], enquanto Finish encerra a sessão de processamento e limpa os dados temporários [SWS_UCM_00354]. Caso ocorram erros, RevertProcessedSwPackages permite a reversão de pacotes processados [SWS_UCM_00350] e Rollback possibilita a restauração do estado do sistema anterior ao processamento do pacote [SWS_UCM_00353].
Os métodos da interface resguardam condições de erro por meio de Application Errors específicos. Em chamadas fora de contexto, métodos como Activate, Cancel, Finish, ProcessSwPackage, TransferData e TransferExit retornam o erro kOperationNotPermitted[SWS_UCM_00346], [SWS_UCM_00347], [SWS_UCM_00349], [SWS_UCM_00352]. IDs de transferência inválidos são rejeitados com kTransferIdInvalid[SWS_UCM_00346], [SWS_UCM_00348], enquanto sequências de blocos incorretas ou restrições de memória resultam em kBlockIncorrect, kBlockSizeIncorrect, kBlockInconsistent ou kMemoryInsufficient[SWS_UCM_00345], [SWS_UCM_00346]. Verificações de segurança e consistência geram erros como kAuthenticationFailed, kPackageInconsistent, kPackageManifestInvalid e kPackageVersionIncompatible[SWS_UCM_00346], [SWS_UCM_00349]. A remoção do sistema central é impedida com kSwclRemovalDenied[SWS_UCM_00349]. Durante a ativação, kDependencyMissing, kUpdateSessionRejected ou kVerificationFailed sinalizam problemas de integração com dependências ou com o State Management [SWS_UCM_00352].
Este guia foi gerado por uma IA com base na especificação AUTOSAR 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.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: b042c91a5838ProcedênciaPerguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
usar
O método de serviço Cancel da interface de serviço PackageManagement serve para interromper prematuramente o processamento em andamento de um pacote de software [SWS_UCM_00351]. Como parâmetro de chamada, o identificador da operação é passado como parâmetro INid do tipo TransferIdType[SWS_UCM_00351]. Como Fire & Forget está definido como false para este método, a chamada de método ocorre de forma síncrona com confirmação ou retorno ao chamador [SWS_UCM_00351].
Tratamento de erros
Se a execução falhar, a interface define códigos de erro específicos (Application Errors) [SWS_UCM_00351]:
kTransferIdInvalid: O ID de transferência transmitido é inválido [SWS_UCM_00351].
kOperationNotPermitted: O cancelamento não é suportado no contexto atual [SWS_UCM_00351].
Interação e concorrência
O método está intimamente relacionado ao processamento de pacotes: uma operação de processamento é tipicamente iniciada via ProcessSwPackage para um TransferIdType id atribuído [SWS_UCM_00349]. Interpretação: Cancel deve ter sido projetado primariamente para cancelar o processamento de pacotes em andamento por meio de ProcessSwPackage[SWS_UCM_00349], [SWS_UCM_00351]. Pergunta Q-a220345676f7046c (aberta) Os chamadores devem assegurar que o ID de transferência exista e que o pacote se encontre em um estado que permita o cancelamento, a fim de evitar o erro kOperationNotPermitted[SWS_UCM_00351].
Este texto foi gerado por uma IA e serve como orientação.
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.
método de serviço ProcessSwPackage [SWS_UCM_00349]Upstream: RS_UCM_00005, RS_UCM_00015 texto ainda não importado, RS_UCM_00026 texto ainda não importado
registers a package that could already be in Machine’s file system or to be downloaded.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 0620dbe84c7eProcedênciaPerguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
usar
O método de serviço RegisterSoftwarePackage pertence à interface de serviço PackageManagement (versão 1.0) e serve para registrar um pacote de software no sistema [SWS_UCM_00344]. O pacote de destino pode já estar localizado localmente no sistema de arquivos da máquina ou ser passado como referência para um download pendente.
O método possui os seguintes parâmetros:
uri (IN, UriString): Especifica o caminho de URI que aponta para o pacote de software a ser registrado [SWS_UCM_00344].
transferId (OUT, TransferIdType): Retorna, após o registro bem-sucedido, um identificador exclusivo para o processo de transferência [SWS_UCM_00344].
Semântica de chamada e tratamento de erros
A propriedade Fire & Forget está definida como false para este serviço [SWS_UCM_00344]. Os chamadores recebem, portanto, uma confirmação direta sobre o resultado do processamento do método. Se a URI passada for sintaticamente inválida ou apontar para um destino inadmissível, a execução falhará com o erro de aplicação específico kInvalidUri[SWS_UCM_00344].
Interação e restrições
A chamada de método forma tipicamente a etapa inicial no fluxo de gerenciamento de pacotes. Como interpretação, o transferId retornado deve ser usado em etapas posteriores do gerenciamento de pacotes para endereçar univocamente o processo de transmissão ou instalação. Como não estão especificadas garantias de concorrência, o chamador deve aguardar a chegada do resultado antes de iniciar ações subsequentes com o identificador em questão. Pergunta Q-fc2bc07c914858a2 (aberta)
Esta nota de uso foi gerada por uma IA com base na especificação AUTOSAR Adaptive R25-11.
método de serviço TransferData [SWS_UCM_00346]Upstream: RS_UCM_00019 texto ainda não importado, RS_UCM_00025 texto ainda não importado
TransferData (IN TransferIdType id, IN ByteVectorType Management data, IN uint64_t blockCounter)
Block-wise transfer of a Software Package to UCM.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: fbad4e8e0243ProcedênciaPerguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
O método de serviço TransferData serve para a transferência em blocos de um pacote de software para o Update and Configuration Management Manager (UCM) dentro da interface de serviço PackageManagement ([SWS_UCM_00346]). Como o método não está definido como Fire & Forget, cada chamada retorna uma confirmação ou um erro de aplicação específico.
Para a chamada, devem ser passados os seguintes parâmetros de entrada ([SWS_UCM_00346]):
id (TransferIdType): A identificação de transferência gerada anteriormente pelo UCM.
data (ByteVectorType Management): O bloco de dados úteis a ser transferido do pacote de software.
blockCounter (uint64_t): O contador sequencial do bloco de dados atual.
Em relação à ordem e à interação, o método pressupõe uma chamada prévia de TransferStart ([SWS_UCM_00345]). Através de TransferStart, o chamador recebe, além do ID de transferência válido, também o tamanho de bloco exigido blockSize bem como a obrigação de indicar o tamanho total do pacote. A transferência de dados deve seguir rigorosamente essas especificações; interpretação: o blockCounter deve ter de ser incrementado pelo chamador de forma monótona e contínua, uma vez que a recepção duplicada do mesmo número de bloco dispara o erro kBlockIncorrect ([SWS_UCM_00346]). Pergunta Q-61272c50c151f4db (aberta)
O tratamento de erros diferencia entre erros estruturais de transferência, problemas de consistência e erros de validação de pacotes ([SWS_UCM_00346]):
Transferência e recursos: Se a sessão for inválida ou o contexto de chamada estiver incorreto, o UCM responde com kTransferIdInvalid ou kOperationNotPermitted. Se um bloco exceder o tamanho acordado ou o tamanho total anunciado, seguem-se kBlockSizeIncorrect ou kSizeIncorrect. Em caso de memória insuficiente ou erros ao persistir, são retornados kMemoryInsufficient ou kTransferFailed.
Integridade e compatibilidade: Se as verificações dos dados falharem, são reportados kBlockInconsistent, kPackageInconsistent ou kAuthenticationFailed. Além disso, são rejeitados manifestos inválidos (kPackageManifestInvalid), versões incompatíveis (kPackageVersionIncompatible, kOldVersion), formatos não suportados (kPackageFormatUnsupported) ou a remoção indevida de Core Clusters (kSwclRemovalDenied).
Esta nota de utilização foi gerada automaticamente com base na especificação AUTOSAR 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 · Original em alemão