Als ara::com-Dienst modellierte Schnittstelle; Methoden/Felder werden über generierte Proxies/Skeletons aufgerufen (Parameterrichtung IN/OUT).
Руководство пользователяСОЗДАНО ИИ
Служит для передачи, обработки, активации и мониторинга программных пакетов и программных кластеров в UCM.
СОЗДАНО ИИне провереноМодель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 6e0698182e67ПроисхождениеОткрытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал
Служит для передачи, обработки, активации и мониторинга программных пакетов и программных кластеров в UCM.
Сервисный интерфейс PackageManagement управляет передачей, обработкой и активацией программных пакетов на AUTOSAR Adaptive Platform [SWS_UCM_00345], [SWS_UCM_00352]. Он обеспечивает блочную загрузку пакетов, извлечение программных кластеров, а также их контролируемую активацию по согласованию со State Management [SWS_UCM_00346], [SWS_UCM_00352]. Кроме того, сервис предоставляет механизмы для мониторинга состояния, а также для отката и очистки данных сессии [SWS_UCM_00353], [SWS_UCM_00361].
1. Роль и системный контекст сервисного интерфейса
Сервисный интерфейс PackageManagement образует центральный интерфейс Update and Configuration Management (UCM) для управления, передачи и установки программных пакетов на AUTOSAR Adaptive Platform [SWS_UCM_00343]. Экземпляр UCM при этом обычно функционирует как поставщик сервиса (Skeleton), тогда как вышестоящие координаторы обновления или диагностические клиенты выступают в качестве потребителей сервиса (Proxy). Для идентификации сервис предоставляет через метод GetId уникальный идентификатор экземпляра модуля [SWS_UCM_00343]. Во время процесса активации UCM тесно взаимодействует со State Management, которое должно авторизовать сессию обновления и выполнить проверки [SWS_UCM_00352].
2. Методы, события и поля
Все методы, определённые в сервисном интерфейсе, работают с синхронной семантикой вызова или с сообщениями «запрос-ответ», так как для всех методов специфицировано Fire & Forget false[SWS_UCM_00345]. Поле состояния CurrentStatus имеет геттер, а также нотификатор, благодаря чему клиенты могут подписаться на изменения статуса UCM по событиям или активно опрашивать их [SWS_UCM_00361]. В дополнение к этому GetProgress предоставляет подробную информацию о ходе выполнения для соответствующего активного состояния конечного автомата [SWS_UCM_00360]. Для запросов состава ПО доступны GetSwPackages для перечисления доступных программных пакетов [SWS_UCM_00359], GetSwClusterInfo для установленных программных кластеров в состоянии kPresent[SWS_UCM_00357], GetSwClusterManifestInfo для данных манифеста кластера [SWS_UCM_00358], а также GetSwClusterChangeInfo для предстоящих изменений в состояниях kAdded, kUpdating или kRemoved[SWS_UCM_00356]. Историческая отслеживаемость выполненных действий обеспечивается через GetHistory с фильтрами по меткам времени [SWS_UCM_00355].
3. Жизненный цикл, процессы сессий и зависимости от состояний
Типичный процесс обновления подразделяется на передачу, обработку, активацию и завершение. Передача пакета либо инициируется с помощью TransferStart, благодаря чему создаётся TransferIdType и согласовывается размер блока [SWS_UCM_00345], либо альтернативно регистрируется с помощью RegisterSoftwarePackage с указанием URI пакета [SWS_UCM_00344]. При блочной передаче блоки данных последовательно сохраняются через TransferData с указанием счётчика блоков [SWS_UCM_00346] и финализируются с помощью TransferExit[SWS_UCM_00347]. Затем ProcessSwPackage извлекает программный пакет [SWS_UCM_00349]. Текущие процессы обработки могут быть отменены с помощью Cancel[SWS_UCM_00351] или приостановлены и возобновлены с помощью Suspend и Resume[SWS_UCM_00397], [SWS_UCM_00398]. Ненужные более передачи можно удалить с помощью DeleteTransfer[SWS_UCM_00348]. С помощью Activate активируются извлечённые программные кластеры [SWS_UCM_00352], тогда как Finish завершает сессию обработки и очищает временные данные [SWS_UCM_00354]. При возникновении ошибок RevertProcessedSwPackages позволяет сбросить обработанные пакеты [SWS_UCM_00350], а Rollback — восстановить состояние системы до обработки пакета [SWS_UCM_00353].
Методы интерфейса страхуют условия ошибок через специфические Application Errors. При вызовах вне контекста такие методы, как Activate, Cancel, Finish, ProcessSwPackage, TransferData и TransferExit, возвращают ошибку kOperationNotPermitted[SWS_UCM_00346], [SWS_UCM_00347], [SWS_UCM_00349], [SWS_UCM_00352]. Недопустимые идентификаторы передачи отклоняются с помощью kTransferIdInvalid[SWS_UCM_00346], [SWS_UCM_00348], тогда как ошибочные последовательности блоков или нехватка памяти приводят к kBlockIncorrect, kBlockSizeIncorrect, kBlockInconsistent или kMemoryInsufficient[SWS_UCM_00345], [SWS_UCM_00346]. Проверки безопасности и согласованности вызывают такие ошибки, как kAuthenticationFailed, kPackageInconsistent, kPackageManifestInvalid, а также kPackageVersionIncompatible[SWS_UCM_00346], [SWS_UCM_00349]. Удаление базовой системы предотвращается с помощью kSwclRemovalDenied[SWS_UCM_00349]. При активации kDependencyMissing, kUpdateSessionRejected или kVerificationFailed сигнализируют о проблемах интеграции с зависимостями или со State Management [SWS_UCM_00352].
Данное руководство было сгенерировано ИИ на основе спецификации 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.
СОЗДАНО ИИне провереноМодель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: b042c91a5838ПроисхождениеОткрытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал
Использование
Сервисный метод Cancel сервисного интерфейса PackageManagement служит для досрочного прерывания текущей обработки программного пакета [SWS_UCM_00351]. В качестве параметра вызова идентификатор операции передаётся как IN-параметр id типа TransferIdType[SWS_UCM_00351]. Поскольку Fire & Forget для этого метода установлен в false, вызов метода выполняется синхронно с подтверждением или обратной связью вызывающей стороне [SWS_UCM_00351].
Обработка ошибок
В случае сбоя выполнения интерфейс определяет специфические коды ошибок (Application Errors) [SWS_UCM_00351]:
kOperationNotPermitted: прерывание в текущем контексте не поддерживается [SWS_UCM_00351].
Взаимодействие и параллелизм
Метод тесно связан с обработкой пакетов: процесс обработки обычно инициируется через ProcessSwPackage для назначенного TransferIdType id[SWS_UCM_00349]. Интерпретация: Cancel, вероятно, ориентирован прежде всего на то, чтобы прервать обработку пакета, выполняемую через ProcessSwPackage[SWS_UCM_00349], [SWS_UCM_00351]. Вопрос Q-a220345676f7046c (открытый) Вызывающие стороны должны убедиться, что Transfer-ID существует и пакет находится в состоянии, допускающем прерывание, во избежание ошибки kOperationNotPermitted[SWS_UCM_00351].
Этот текст был сгенерирован ИИ и служит в качестве ориентировочного руководства.
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.
registers a package that could already be in Machine’s file system or to be downloaded.
СОЗДАНО ИИне провереноМодель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 0620dbe84c7eПроисхождениеОткрытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал
Использование
Сервисный метод RegisterSoftwarePackage относится к сервисному интерфейсу PackageManagement (версия 1.0) и служит для регистрации пакета программного обеспечения в системе [SWS_UCM_00344]. При этом целевой пакет может уже находиться локально в файловой системе машины или передаваться как ссылка для предстоящей загрузки.
Метод имеет следующие параметры:
uri (IN, UriString): указывает путь URI, ссылающийся на регистрируемый пакет программного обеспечения [SWS_UCM_00344].
transferId (OUT, TransferIdType): после успешной регистрации возвращает уникальный идентификатор для процесса передачи [SWS_UCM_00344].
Семантика вызова и обработка ошибок
Свойство Fire & Forget для этой службы установлено в false[SWS_UCM_00344]. Поэтому вызывающие стороны получают прямое квитирование о результате выполнения метода. Если переданный URI синтаксически недействителен или указывает на недопустимую цель, выполнение завершается со специфической ошибкой приложения kInvalidUri[SWS_UCM_00344].
Взаимодействие и ограничения
Вызов метода обычно образует начальный шаг в процессе управления пакетами. Возвращённый transferId, предположительно, согласно интерпретации используется на дальнейших шагах управления пакетами для однозначной адресации процесса передачи или установки. Вопрос Q-fc2bc07c914858a2 (открытый) Поскольку никаких гарантий параллелизма не специфицировано, вызывающей стороне следует дождаться получения результата, прежде чем инициировать последующие действия с соответствующим идентификатором.
Это указание по использованию было сгенерировано ИИ на основе спецификации AUTOSAR Adaptive R25-11.
сервисный метод TransferData [SWS_UCM_00346]Upstream: RS_UCM_00019 текст ещё не импортирован, RS_UCM_00025 текст ещё не импортирован
TransferData (IN TransferIdType id, IN ByteVectorType Management data, IN uint64_t blockCounter)
Block-wise transfer of a Software Package to UCM.
СОЗДАНО ИИне провереноМодель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: fbad4e8e0243ПроисхождениеОткрытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал
Сервисный метод TransferData служит для блочной передачи пакета программного обеспечения менеджеру Update and Configuration Management (UCM) в рамках сервисного интерфейса PackageManagement ([SWS_UCM_00346]). Поскольку метод не определён как Fire & Forget, каждый вызов возвращает подтверждение или специфическую ошибку приложения.
Для вызова необходимо передать следующие входные параметры ([SWS_UCM_00346]):
id (TransferIdType): идентификатор передачи, предварительно созданный UCM.
data (ByteVectorType Management): передаваемый блок полезных данных пакета программного обеспечения.
blockCounter (uint64_t): последовательный счётчик текущего блока данных.
С точки зрения порядка выполнения и взаимодействия метод предполагает предварительный вызов TransferStart ([SWS_UCM_00345]). Через TransferStart вызывающая сторона получает не только действительный Transfer-ID, но и требуемый размер блока blockSize, а также обязательство указать общий размер пакета. Передача данных должна строго следовать этим предписаниям; интерпретация: вызывающая сторона, вероятно, должна монотонно и без пропусков инкрементировать blockCounter, поскольку повторный приём одного и того же номера блока вызывает ошибку kBlockIncorrect ([SWS_UCM_00346]). Вопрос Q-61272c50c151f4db (открытый)
Обработка ошибок различает структурные ошибки передачи, проблемы согласованности и ошибки валидации пакетов ([SWS_UCM_00346]):
Передача и ресурсы: если сессия недействительна или контекст вызова неверен, UCM возвращает kTransferIdInvalid или kOperationNotPermitted. Если блок превышает согласованный размер или заявленный общий размер, следуют kBlockSizeIncorrect или kSizeIncorrect соответственно. При нехватке памяти или ошибках сохранения возвращаются kMemoryInsufficient или kTransferFailed.
Целостность и совместимость: если проверки данных завершаются неудачно, регистрируются kBlockInconsistent, kPackageInconsistent или kAuthenticationFailed. Кроме того, отклоняются недействительные манифесты (kPackageManifestInvalid), несовместимые версии (kPackageVersionIncompatible, kOldVersion), неподдерживаемые форматы (kPackageFormatUnsupported) или недопустимое удаление core-кластеров (kSwclRemovalDenied).
Это указание по использованию было сгенерировано автоматически на основе спецификации 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 · Немецкий оригинал