DEENESPTFRRUARHIKOZHNL

класс ara::diag::SovdSwUpdate

[SWS_DM_01874] Upstream: RS_Diag_04265

class SovdSwUpdate {...};

Class to implement the SovdSwUpdate interface.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopenamespace ara::diag

Руководство пользователяСОЗДАНО ИИ

Служит интерфейсом для выполнения обновлений программного обеспечения по протоколу ASAM SOVD в диагностическом сервере AUTOSAR.
СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 0456e379cc70 Происхождение Открытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Служит интерфейсом для выполнения обновлений программного обеспечения по протоколу ASAM SOVD в диагностическом сервере AUTOSAR.

Класс предоставляет интерфейс со стороны приложения для выполнения стандартизированных обновлений программного обеспечения по протоколу SOVD в соответствии с ASAM SOVD [SWS_DM_01796]. После инстанцирования приложение активирует пересылку диагностических запросов специфическим обработчикам обновления через метод Offer() [SWS_DM_01924]. Через асинхронные методы пакеты регистрируются, подготавливаются, устанавливаются автоматически или вручную, а также снова удаляются. Все процессы, связанные с передачей данных и жизненным циклом, обрабатываются при этом неблокирующим образом через future-объекты.

Контекст

Класс ara::diag::SovdSwUpdate определяет интерфейс для реализации стандартизированных обновлений программного обеспечения в соответствии с ASAM SOVD в AUTOSAR Adaptive Platform [SWS_DM_01874]. Поскольку сама бизнес-логика обновлений программного обеспечения находится не в функциональном кластере Diagnostic Management (DM), выполнение остается за соответствующим приложением, тогда как ara::diag::SovdSwUpdate концентрируется на стандартизированной обработке базового протокола SOVD AUTOSAR_AP_SWS_Diagnostics §7.4 «SOVD Software Update API - concept». Для загрузки файлов обновлений при этом используются стратегии передачи, специфицированные для службы UDS 0x38 (RequestFileTransfer) AUTOSAR_AP_SWS_Diagnostics §7.4 «SOVD Software Update API - concept», [SWS_DM_01923].

В процессах участвуют три основных компонента: внешний клиент SOVD, экземпляр Diagnostic Server (DM) для управления протоколами и маршрутизацией, а также зависящая от приложения реализация обработчика ara::diag::SovdSwUpdate [SWS_DM_01796], [SWS_DM_01924].

SovdSwUpdateContext client SOVD-Client dm Diagnostic Server (DM) client->dm SOVD-Protokoll (ASAM SOVD) handler ara::diag::SovdSwUpdate (Anwendungs-Handler) dm->handler Methodenaufrufe (z. B. Prepare/Execute) handler->dm ara::core::Future

Контекстная диаграмма: взаимодействие между клиентом SOVD, Diagnostic Server (DM) и ara::diag::SovdSwUpdate. Источники: [SWS_DM_01796], [SWS_DM_01924], AUTOSAR_AP_SWS_Diagnostics §7.4 «SOVD Software Update API - concept».

Жизненный цикл

Создание экземпляра ara::diag::SovdSwUpdate выполняется через конструктор с указанием ara::core::InstanceSpecifier, ссылающегося на прототип порта смоделированного DiagnosticSovdUpdateInterface, а также режима параллелизма (ConcurrencyType: kConcurrent или kNotConcurrent) [SWS_DM_01910]. Конструктор специфицирован как потокобезопасный и исключениебезопасный [SWS_DM_01910]. Будучи представителем уникального экземпляра интерфейса, конструктор копирования и оператор присваивания копированием удалены (=delete) и защищены [SWS_DM_01912], [SWS_DM_01914]. Конструирование перемещением и присваивание перемещением доступны в защищенном режиме, однако не являются потокобезопасными [SWS_DM_01913], [SWS_DM_01915].

Уничтожение объекта выполняется через виртуальный деструктор ~SovdSwUpdate(), который считается непотокобезопасным [SWS_DM_01911]. Должны ли виртуальные методы обратного вызова класса выполняться параллельно, напрямую зависит от переданного конструктору ConcurrencyType [SWS_DM_01910], [SWS_DM_01916].

Путь использования

Интерпретация: поскольку предоставляемые методы интерфейса объявлены чисто виртуальными (=0), производный прикладной класс, по всей видимости, должен реализовывать их для выполнения фактического обновления, в то время как базовый класс регулирует подключение к платформе. Вопрос Q-10500d9fc58503ea (открытый)

Стандартный процесс делится на следующие фазы:

  • Предоставление: после создания объекта приложение вызывает Offer(), чтобы позволить Diagnostic Management перенаправлять входящие сообщения SOVD этому экземпляру [SWS_DM_01924].
  • Запрос сведений и регистрация: через GetAllUpdates() можно запросить существующие пакеты обновления [SWS_DM_01797], [SWS_DM_01916]. Если требуется передать новый пакет, Diagnostic Server запрашивает регистрацию через RequestUpdatePackageRegistration(), которая асинхронно предоставляет сессию записи (DataTransferWriteSession) вместе с идентификатором пакета обновления [SWS_DM_01923]. Подробности и статус определяются через GetUpdatePackageDetails() и GetUpdatePackageStatus() [SWS_DM_01802], [SWS_DM_01917], [SWS_DM_01921].
  • Установка или удаление: установка может запускаться либо автоматически с помощью PutUpdatePackageAutomated() [SWS_DM_01799], [SWS_DM_01918], либо выполняться в два этапа через PrepareUpdatePackage() [SWS_DM_01800], [SWS_DM_01919] с последующим ExecuteUpdatePackage() [SWS_DM_01801], [SWS_DM_01920]. Пакеты, которые больше не требуются, удаляются через DeleteUpdatePackage() [SWS_DM_01922].
  • Завершение: перед завершением работы приложение деактивирует пересылку сообщений вызовом StopOffer() [SWS_DM_01925].
Процесс обновления программного обеспечения через SOVDSOVD-ClientDiagnostic ServerSovdSwUpdateUse Case: DienstfreigabeOffer()Result<void>Use Case: Регистрация пакета обновленияSOVD: Register UpdateRequestUpdatePackageRegistration(metaInfo, expectedSize, cancellationHandler)Future<tuple<DataTransferWriteSession, updatePackageId>>SOVD Response (Session & Package-ID)Use Case: Подготовка и установкаSOVD: Prepare InstallationPrepareUpdatePackage(updatePackageId, metaInfo, cancellationHandler)Future<void>SOVD ResponseSOVD: Execute InstallationExecuteUpdatePackage(updatePackageId, metaInfo, cancellationHandler)Future<void>SOVD Response

Диаграмма последовательности: типовой процесс регистрации и установки пакета через SOVD. Источники: [SWS_DM_01799], [SWS_DM_01800], [SWS_DM_01801], [SWS_DM_01919], [SWS_DM_01920], [SWS_DM_01923], [SWS_DM_01924]

Сценарии ошибок

При предложении служб через Offer() могут возникать специфические ошибки в типе возвращаемого значения ara::core::Result<void>: DiagOfferErrc::kAlreadyOffered, если экземпляр уже предложен, а также DiagOfferErrc::kConfigurationMismatch, если конфигурация не совпадает с диагностическим экстрактом (DEXT) [SWS_DM_01924].

Если конструктор вызывается с некорректным состоянием модели, сообщается об архитектурных нарушениях, включая InstanceSpecifierMappingIntegrityViolation, PortInterfaceMappingViolation, ProcessMappingViolation или InstanceSpecifierAlreadyInUseViolation [SWS_DM_01910].

Все функциональные операции обновления возвращают ara::core::Future, который в случае ошибки передает коды ошибок в соответствии с ASAM SOVD 1.1 или ISO 17978-3 [SWS_DM_01917], [SWS_DM_01919], [SWS_DM_01920], [SWS_DM_01923]. Кроме того, все асинхронные методы принимают CancellationHandler, через который сигнализируется о преждевременном прерывании текущего диагностического соединения [SWS_DM_01916], [SWS_DM_01919], [SWS_DM_01923].

Настоящее руководство основано на спецификации AUTOSAR Adaptive R25-11 и создано автоматически.

Карта членов

Диаграмма классов

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__diag__SovdSwUpdate737 SovdSwUpdate + ~SovdSwUpdate() + SovdSwUpdate() + DeleteUpdatePackage() + ExecuteUpdatePackage() + GetAllUpdates() + GetUpdatePackageDetails() + GetUpdatePackageStatus() + Offer() + PrepareUpdatePackage() + PutUpdatePackageAutomated() + RequestUpdatePackageRegistration() + StopOffer() + operator=()

Подробный вид

Выберите элемент в оглавлении.

Конструкторы и деструктор

SovdSwUpdate функция 3

Constructor for SovdSwUpdate.

Перегрузки SovdSwUpdate 3
SovdSwUpdate (ara::core::InstanceSpecifier const &instanceSpecifier, ConcurrencyType concurrencyType) noexcept; SWS_DM_01910
SovdSwUpdate (SovdSwUpdate const &)=delete; SWS_DM_01912
SovdSwUpdate (SovdSwUpdate &&other) noexcept; SWS_DM_01913
~SovdSwUpdate функция

Destructor of class SovdSwUpdate.

virtual ~SovdSwUpdate () noexcept;

Методы

DeleteUpdatePackage функция

Called for SOVD method "Delete Update Package from an SOVD Server".

virtual ara::core::Future< void > DeleteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;
ExecuteUpdatePackage функция

Called for SOVD method "Execute Installation of an Update".

virtual ara::core::Future< void > ExecuteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;
GetAllUpdates функция

Called for SOVD method "Retrieve List of All Updates".

virtual ara::core::Future< ara::core::Vector< ara::core::String > > GetAllUpdates (ara::core::String targetVersion, ara::core::String origin, MetaInfo const &metaInfo, CancellationHandler cancellation Handler) noexcept=0;

Called for SOVD method "Get Details of Update".

virtual ara::core::Future< UpdatePackageDetails > GetUpdatePackage Details (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;
GetUpdatePackageStatus функция

Called for SOVD method "Get Status of an Update".

virtual ara::core::Future< UpdatePackageStatus > GetUpdatePackage Status (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;
Offer функция

This Offer will enable the DM to forward request messages to this handler.

ara::core::Result< void > Offer () noexcept;
PrepareUpdatePackage функция

Called for SOVD method "Prepare Installation of an Update".

virtual ara::core::Future< void > PrepareUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Automated Installation of an Update".

virtual ara::core::Future< void > PutUpdatePackageAutomated (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Register an Update at the SOVD Server".

virtual ara::core::Future< std::tuple< DataTransferWriteSession, ara::core::String > > RequestUpdatePackageRegistration (MetaInfo const &metaInfo, ara::core::Optional< uint64_t > expectedSize, Cancellation Handler cancellationHandler) noexcept=0;
StopOffer функция

This StopOffer will disable the forwarding of request messages from DM.

void StopOffer () const noexcept;

Операторы

operator= функция 2

SovdSwUpdate shall be a single not assignable instance.

Перегрузки = 2
SovdSwUpdate & operator= (SovdSwUpdate const &)=delete; SWS_DM_01914
SovdSwUpdate & operator= (SovdSwUpdate &&other) & noexcept; SWS_DM_01915

Вложенные типы

SubProgress класс

Документация методов

функция DeleteUpdatePackage [SWS_DM_01922] Upstream: RS_Diag_04265

virtual ara::core::Future< void > DeleteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Delete Update Package from an SOVD Server".

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 8b58fd563e10 Происхождение
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Чисто виртуальная функция DeleteUpdatePackage класса ara::diag::SovdSwUpdate вызывается согласно [SWS_DM_01803] экземпляром Diagnostic Server, когда требуется выполнить SOVD-метод «Delete Update Package from an SOVD Server» ([SWS_DM_01922]). Она инициирует удаление пакета обновления на стороне сервера.

Вызов выполняется асинхронно и возвращает ara::core::Future<void>, которое указывает на успешное завершение или предоставляет объект ошибки [SWS_DM_01922]. Сигнатура требует следующих входных параметров:

  • updatePackageId: обозначает как ara::core::String уникальный ID удаляемого пакета обновления.
  • metaInfo: передает в виде MetaInfo const& дополнительную контекстную информацию запроса.
  • cancellationHandler: передает объект типа CancellationHandler, информирующий о том, был ли прерван текущий диалог.

Если во время обработки возникает ошибка, Future заполняется соответствующей ошибкой SOVD. Спецификация предписывает для этого использование подходящих кодов ошибок из ASAM SOVD 1.1 или ISO 17978-3 [SWS_DM_01922].

Что касается конкурентности, метод определен как условно потокобезопасный: должна ли реализация выполняться потокобезопасной (thread-safe) или непотокобезопасной (non-thread-safe), определяется через ConcurrencyType, переданный в конструктор [SWS_DM_01922]. Кроме того, функция объявлена как noexcept и безопасная относительно исключений, вследствие чего исключения не должны выходить за ее пределы.

Это указание по использованию основано на спецификации AUTOSAR Adaptive R25-11 и было сгенерировано ИИ.

Руководство разработчика реализации в подготовке (сложность I1)

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
updatePackageIdupdate-package-id to be deleted
metaInfoMetaInfo of the request.
cancellationHandlerInforms if the current conversation is cancelled

Rückgabewert

TypBeschreibung
ara::core::Future< void >A future with either a positive results or a SOVD Error

Fehler

FehlercodeBeschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01922
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01922@rel:R25-11#7fb5516c
Content hash
7fb5516c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01922
Status: valid/unmigrated Version: rel:R25-11#3e5d5362 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01922@rel:R25-11#3e5d5362
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#6203bff42026-09-30
  • R23-11rel:R23-11#af1834882026-10-14
  • R24-11rel:R24-11#113a04fa2026-10-14
  • R25-11rel:R25-11#3e5d53622026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция ExecuteUpdatePackage [SWS_DM_01920] Upstream: RS_Diag_04265

virtual ara::core::Future< void > ExecuteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Execute Installation of an Update".

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: df9b45c15e08 Происхождение Открытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Использование

Чисто виртуальный метод ExecuteUpdatePackage интерфейса ara::diag::SovdSwUpdate служит для выполнения SOVD-метода «Execute Installation of an Update» [SWS_DM_01920]. Объявление находится в заголовочном файле ara/diag/sovd_sw_update.h AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.2 «ExecuteUpdatePackage». В качестве входных параметров передаются идентификатор пакета обновления (updatePackageId) и данные запроса (metaInfo) [SWS_DM_01920]. Кроме того, объект cancellationHandler информирует о том, если текущий диалог был прерван [SWS_DM_01920]. Вызов выполняется асинхронно и возвращает ara::core::Future<void>, которое предоставляет положительный результат или сообщает об ошибке SOVD [SWS_DM_01920].

Обработка ошибок

Интерфейс специфицирован как noexcept и безопасный относительно исключений («exception safe») [SWS_DM_01920]. Ошибки во время выполнения, следовательно, не должны генерироваться через C++-исключения, а должны возвращаться асинхронно через ara::core::Future с применимыми кодами ошибок из ASAM SOVD 1.1 или ISO 17978-3 [SWS_DM_01920].

Параллелизм и граничные условия

В отношении потокобезопасности существует условное требование («conditional»): должна ли функция реализовываться потокобезопасной или непотокобезопасной, определяется через параметр ConcurrencyType, переданный конструктору [SWS_DM_01920]. Реализация, вероятно, должна анализировать cancellationHandler, чтобы штатно завершить установку пакета при прерывании диалога [SWS_DM_01920]. Вопрос Q-8fe6950e8f5a168c (открытый)

Этот текст был сгенерирован ИИ и служит в качестве справочного материала. Обязательную силу имеют исключительно официальные спецификации AUTOSAR.

Руководство разработчика реализации в подготовке (сложность I1)

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
updatePackageIdupdate-package-id of the update to be executed
metaInfoMetaInfo of the request.
cancellationHandlerInforms if the current conversation is cancelled

Rückgabewert

TypBeschreibung
ara::core::Future< void >A future with either a positive results or a SOVD Error

Fehler

FehlercodeBeschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01920
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01920@rel:R25-11#b2479fe6
Content hash
b2479fe6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01920
Status: valid/unmigrated Version: rel:R25-11#250ba828 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01920@rel:R25-11#250ba828
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#da8394102026-09-30
  • R23-11rel:R23-11#c3f2b7802026-10-14
  • R24-11rel:R24-11#f4456b492026-10-14
  • R25-11rel:R25-11#250ba8282026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция GetAllUpdates [SWS_DM_01916] Upstream: RS_Diag_04265

virtual ara::core::Future< ara::core::Vector< ara::core::String > > GetAllUpdates (ara::core::String targetVersion, ara::core::String origin, MetaInfo const &metaInfo, CancellationHandler cancellation Handler) noexcept=0;

Called for SOVD method "Retrieve List of All Updates".

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
targetVersionOptional parameter to be used if the target-version query parameter is used in the request. If the parameter is not set the String shall be left empty. set in the request the String shall be left empty
originOptional parameter to be used if the origin query parameter is used in the request. If the parameter is not set the String shall be left empty
metaInfoMetaInfo of the request.
cancellationHandlerInforms if the current conversation is cancelled

Rückgabewert

TypBeschreibung
ara::core::Future<ara::core::Vector<ara::core::String > >A future with a span of all update package ids. The span shall not be modified until the releaseHandler is called.

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01916
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01916@rel:R25-11#444ef55c
Content hash
444ef55c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01916
Status: valid/unmigrated Version: rel:R25-11#fa31eee5 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01916@rel:R25-11#fa31eee5
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#cfb37af32026-09-30
  • R23-11rel:R23-11#1313500b2026-10-14
  • R24-11rel:R24-11#2fff52ce2026-10-14
  • R25-11rel:R25-11#fa31eee52026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция GetUpdatePackageDetails [SWS_DM_01917] Upstream: RS_Diag_04265

virtual ara::core::Future< UpdatePackageDetails > GetUpdatePackage Details (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Get Details of Update".

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
updatePackageIdupdate-package-id of the update to be read
metaInfoMetaInfo of the request.
cancellationHandlerInforms if the current conversation is cancelled

Rückgabewert

TypBeschreibung
ara::core::Future<UpdatePackageDetails >A future with the details of the requested update package or a SOVD Error

Fehler

FehlercodeBeschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01917
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01917@rel:R25-11#6f4fa008
Content hash
6f4fa008
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01917
Status: valid/unmigrated Version: rel:R25-11#08879f75 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01917@rel:R25-11#08879f75
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#5194b7fa2026-09-30
  • R23-11rel:R23-11#bed00f3c2026-10-14
  • R24-11rel:R24-11#71be4b722026-10-14
  • R25-11rel:R25-11#08879f752026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция GetUpdatePackageStatus [SWS_DM_01921] Upstream: RS_Diag_04265

virtual ara::core::Future< UpdatePackageStatus > GetUpdatePackage Status (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Get Status of an Update".

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
updatePackageIdupdate-package-id of which the status shall be read
metaInfoMetaInfo of the request.
cancellationHandlerInforms if the current conversation is cancelled

Rückgabewert

TypBeschreibung
ara::core::Future<UpdatePackageStatus >A future with either the current UpdatePackageStatus or a SOVD Error

Fehler

FehlercodeBeschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01921
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01921@rel:R25-11#e4feecaf
Content hash
e4feecaf
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01921
Status: valid/unmigrated Version: rel:R25-11#a8720fc8 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01921@rel:R25-11#a8720fc8
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#6c5291e82026-09-30
  • R23-11rel:R23-11#6a27c4202026-10-14
  • R24-11rel:R24-11#f41bfa0b2026-10-14
  • R25-11rel:R25-11#a8720fc82026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция Offer [SWS_DM_01924] Upstream: RS_Diag_04265

ara::core::Result< void > Offer () noexcept;

This Offer will enable the DM to forward request messages to this handler.

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 5d09bdcb924c Происхождение Открытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Функция-элемент ara::diag::SovdSwUpdate::Offer регистрирует обработчик обновлений ПО SOVD в Diagnostic Management (DM), чтобы позволить ему пересылать входящие сообщения-запросы обработчику [SWS_DM_01924]. Вызов выполняется синхронно и без параметров через заголовочный файл ara/diag/sovd_sw_update.h и согласно noexcept не вызывает C++-исключений [SWS_DM_01924].

Результат операции возвращается как ara::core::Result<void> [SWS_DM_01924]. В случае сбоя предоставления функция возвращает ошибку с семантикой отката [SWS_DM_01924]:

  • DiagOfferErrc::kAlreadyOffered: служба уже успешно предлагалась для этого обработчика ранее [SWS_DM_01924].
  • DiagOfferErrc::kConfigurationMismatch: конфигурация монитора не совпадает с конфигурацией DEXT [SWS_DM_01924].

Что касается конкурентности, метод специфицирован как exception safe, но явно как непотокобезопасный (not thread-safe) [SWS_DM_01924]. Интерпретация: при обращениях из нескольких потоков, вероятно, потребуется внешняя синхронизация со стороны приложения. Вопрос Q-4636ad27701d59df (открытый) Принцип предоставления через Offer соответствует общей схеме для таких диагностических обработчиков, как [SWS_DM_00557] или [SWS_DM_00735], при которой DM может пересылать запросы только после того, как соответствующий интерфейс будет активно предложен [SWS_DM_01525].

Это указание по использованию было сгенерировано автоматически на основе спецификации AUTOSAR Adaptive R25-11.

Руководство разработчика реализации в подготовке (сложность I1)

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >Returns nothing or an error.

Fehler

FehlercodeBeschreibung
DiagOfferErrc::kConfigurationMismatchrollback_semantics monitor configuration does not match DEXT
DiagOfferErrc::kAlreadyOfferedrollback_semantics The service is already offered.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01924
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01924@rel:R25-11#902c240f
Content hash
902c240f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01924
Status: valid/unmigrated Version: rel:R25-11#1b6fc58c Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01924@rel:R25-11#1b6fc58c
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#4434cb652026-09-30
  • R23-11rel:R23-11#032ce7bb2026-10-14
  • R24-11rel:R24-11#438685592026-10-14
  • R25-11rel:R25-11#1b6fc58c2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция PrepareUpdatePackage [SWS_DM_01919] Upstream: RS_Diag_04265

virtual ara::core::Future< void > PrepareUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Prepare Installation of an Update".

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 90a902e7c6d4 Происхождение Открытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Чисто виртуальный метод PrepareUpdatePackage интерфейса ara::diag::SovdSwUpdate служит для подготовки установки пакета обновления программного обеспечения в рамках SOVD-метода «Prepare Installation of an Update» согласно [SWS_DM_01919] (AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.7 «PrepareUpdatePackage»).

Вызов и параметры

Функция предоставляется через заголовочный файл ara/diag/sovd_sw_update.h и принимает следующие параметры:

  • updatePackageId: идентификатор (ara::core::String) подготавливаемого пакета обновления.
  • metaInfo: метаданные (MetaInfo const&) входящего SOVD-запроса.
  • cancellationHandler: объект мониторинга (CancellationHandler), информирующий о прерывании текущего диалога.

Вызов специфицирован как noexcept и ведет себя безопасно относительно исключений (exception-safe). Асинхронный результат предоставляется через ara::core::Future<void>, которое либо сигнализирует об успешном завершении, либо предоставляет ошибку [SWS_DM_01919].

Обработка ошибок и параллелизм

Если во время подготовки возникает ошибка, в Future должен быть возвращен подходящий код ошибки согласно ASAM SOVD 1.1 или ISO 17978-3 [SWS_DM_01919]. В отношении потокобезопасности действует условное требование (conditional): должна ли функция реализовываться потокобезопасной, определяется через ConcurrencyType, указанный в конструкторе при инстанцировании [SWS_DM_01919]. С помощью объекта cancellationHandler приложение, вероятно, должно иметь возможность прерывать длительные шаги подготовки, если запрос завершается досрочно. Вопрос Q-be4c53d9a0427ed5 (открытый)

Этот текст был создан ИИ на основе спецификации AUTOSAR.

Руководство разработчика реализации в подготовке (сложность I1)

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
updatePackageIdupdate-package-id of the update to be prepared
metaInfoMetaInfo of the request.
cancellationHandlerInforms if the current conversation is cancelled

Rückgabewert

TypBeschreibung
ara::core::Future< void >A future with either a positive result or a SOVD Error

Fehler

FehlercodeBeschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01919
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01919@rel:R25-11#4492da66
Content hash
4492da66
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01919
Status: valid/unmigrated Version: rel:R25-11#7bdc8dcb Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01919@rel:R25-11#7bdc8dcb
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#d529788a2026-09-30
  • R23-11rel:R23-11#cb96813b2026-10-14
  • R24-11rel:R24-11#124b85892026-10-14
  • R25-11rel:R25-11#7bdc8dcb2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция PutUpdatePackageAutomated [SWS_DM_01918] Upstream: RS_Diag_04265

virtual ara::core::Future< void > PutUpdatePackageAutomated (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Automated Installation of an Update".

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: a14ff9457ed9 Происхождение
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Использование

Чисто виртуальный метод PutUpdatePackageAutomated вызывается в контексте SOVD-метода «Automated Installation of an Update» [SWS_DM_01918]. Он объявлен в заголовочном файле ara/diag/sovd_sw_update.h внутри класса ara::diag::SovdSwUpdate AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.8 «PutUpdatePackageAutomated». Функция служит для автоматизированной установки пакета обновления, специфицированного своим идентификатором.

Интерфейс ожидает следующие входные параметры:

  • updatePackageId (ara::core::String): идентификатор пакета обновления, который должен быть передан для автоматизированной установки [SWS_DM_01918].
  • metaInfo (MetaInfo const &): метаинформация входящего запроса службы [SWS_DM_01918].
  • cancellationHandler (CancellationHandler): информирует операцию о том, был ли прерван текущий диалог [SWS_DM_01918].

Вызов обладает асинхронной семантикой. В качестве возвращаемого значения служит ara::core::Future<void>, которое после завершения либо указывает на успешное выполнение, либо содержит состояние ошибки [SWS_DM_01918].

Обработка ошибок и параллелизм

В случае ошибки через future должен быть возвращен применимый код ошибки из ASAM SOVD 1.1 или ISO 17978-3 [SWS_DM_01918]. Метод специфицирован как безопасный относительно исключений (exception safe) и как функция noexcept не генерирует C++-исключений AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.8 «PutUpdatePackageAutomated».

Потокобезопасность метода является условной (conditional): должна ли реализация выполняться потокобезопасной (thread-safe) или непотокобезопасной (non-thread-safe), определяется через ConcurrencyType, переданный при вызове конструктора [SWS_DM_01918].

Это указание по использованию было создано автоматически на основе спецификации AUTOSAR для релиза R25-11.

Руководство разработчика реализации в подготовке (сложность I1)

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
updatePackageIdupdate-package-id of the update to be put to automated
metaInfoMetaInfo of the request.
cancellationHandlerInforms if the current conversation is cancelled

Rückgabewert

TypBeschreibung
ara::core::Future< void >A future with either a positive result or a SOVD Error

Fehler

FehlercodeBeschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01918
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01918@rel:R25-11#11aa0d06
Content hash
11aa0d06
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01918
Status: valid/unmigrated Version: rel:R25-11#befb20e2 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01918@rel:R25-11#befb20e2
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#cde948f42026-09-30
  • R23-11rel:R23-11#97eae9312026-10-14
  • R24-11rel:R24-11#0f5da9f52026-10-14
  • R25-11rel:R25-11#befb20e22026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция RequestUpdatePackageRegistration [SWS_DM_01923] Upstream: RS_Diag_04265

virtual ara::core::Future< std::tuple< DataTransferWriteSession, ara::core::String > > RequestUpdatePackageRegistration (MetaInfo const &metaInfo, ara::core::Optional< uint64_t > expectedSize, Cancellation Handler cancellationHandler) noexcept=0;

Called for SOVD method "Register an Update at the SOVD Server".

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: bf978796d20b Происхождение Открытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Чисто виртуальная функция RequestUpdatePackageRegistration класса ara::diag::SovdSwUpdate обслуживает SOVD-метод «Register an Update at the SOVD Server» [SWS_DM_01923]. Она запускает регистрацию пакета обновления на сервере и инициирует сопутствующий сеанс передачи AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.9 «RequestUpdatePackageRegistration».

Вызов выполняется асинхронно и возвращает ara::core::Future, которое в случае успеха содержит кортеж, состоящий из DataTransferWriteSession и ara::core::String с ID пакета обновления [SWS_DM_01923]. При вызове передаются следующие параметры:

  • metaInfo: метаинформация входящего запроса.
  • expectedSize: опциональный ожидаемый общий размер пакета (ara::core::Optional<uint64_t>), если он указан в запросе.
  • cancellationHandler: сигнализирует, если текущий диалог прерывается.

Метод определен как noexcept и безопасен относительно исключений [SWS_DM_01923]. Ошибки, следовательно, не сообщаются через C++-исключения, а предоставляются асинхронно через future; для этого должны использоваться соответствующие коды ошибок из ASAM SOVD 1.1 или ISO 17978-3 [SWS_DM_01923].

Потокобезопасность является условной («conditional»): должна ли функция реализовываться потокобезопасной, определяется через ConcurrencyType, указанный в конструкторе [SWS_DM_01923]. Поэтому конкретная реализация, в зависимости от инстанцирования, вероятно, может требовать собственных механизмов синхронизации. Вопрос Q-7e80e557bdd7627a (открытый)

Этот текст был создан ИИ и служит для поддержки при использовании элемента API.

Руководство разработчика реализации в подготовке (сложность I1)

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
metaInfoMetaInfo of the request.
expectedSizeSpecifies the expected size if available in the request.
cancellationHandlerInforms if the current conversation is cancelled

Rückgabewert

TypBeschreibung
ara::core::Future<std::tuple< DataTransferWriteSession, ara::core::String > >A future with either an instance of a "SOVD file writing session" with the corresponding update package id or a SOVD Error

Fehler

FehlercodeBeschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01923
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01923@rel:R25-11#9352ef80
Content hash
9352ef80
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01923
Status: valid/unmigrated Version: rel:R25-11#b092f8d8 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01923@rel:R25-11#b092f8d8
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#0245e3c02026-09-30
  • R23-11rel:R23-11#c6f57bb12026-10-14
  • R24-11rel:R24-11#5e5e1b832026-10-14
  • R25-11rel:R25-11#b092f8d82026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция SovdSwUpdate [SWS_DM_01910] Upstream: RS_Diag_04265, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

SovdSwUpdate (ara::core::InstanceSpecifier const &instanceSpecifier, ConcurrencyType concurrencyType) noexcept;

Constructor for SovdSwUpdate.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe
Verletzungen (Violations)InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of your executable, or it refers to a model element other tegrityViolation than a PortPrototype. PortInterfaceMap- A PortPrototype that is referenced by a pingViolation DiagnosticSovdUpdatePortMapping needs to be typed by a DiagnosticSovdUpdateInterface. ProcessMappingVio- Matching InstanceRef exists, but no matching (modelled) Process lation found that matches the (runtime) process. InstanceSpecifier- Violation message that is sent in case a constructor in the ara AlreadyInUseViola- framework was called with an InstanceSpecifier already in use in tion this process.

Parameter (in)

ParameterBeschreibung
instanceSpecifierInstanceSpecifier to a PortPrototype of a DiagnosticSovdUpdateInterface service instance in the manifest.
concurrencyTypeSpecifies if the interface is implemented as thread safe ( kConcurrent) or non-thread safe (kNotConcurrent).

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01910
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01910@rel:R25-11#3f1914fb
Content hash
3f1914fb
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01910
Status: valid/unmigrated Version: rel:R25-11#39b10a70 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01910@rel:R25-11#39b10a70
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#5bc9aa6d2026-09-30
  • R23-11rel:R23-11#cb3f1d3a2026-10-14
  • R24-11rel:R24-11#71a1ee492026-10-14
  • R25-11rel:R25-11#39b10a702026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция SovdSwUpdate [SWS_DM_01912] Upstream: RS_Diag_04265

SovdSwUpdate (SovdSwUpdate const &)=delete;

SovdSwUpdate shall be a single not copy-able instance.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Sichtbarkeitprotected

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01912
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01912@rel:R25-11#c3ca7011
Content hash
c3ca7011
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01912
Status: valid/unmigrated Version: rel:R25-11#a9b2eed0 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01912@rel:R25-11#a9b2eed0
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#29457c012026-09-30
  • R23-11rel:R23-11#920c2b292026-10-14
  • R24-11rel:R24-11#a9b2eed02026-10-14
  • R25-11rel:R25-11#a9b2eed02026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция SovdSwUpdate [SWS_DM_01913] Upstream: RS_Diag_04265

SovdSwUpdate (SovdSwUpdate &&other) noexcept;

Move constructs an instance of SovdSwUpdate.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Exception-Sicherheitexception safe
Thread-Sicherheitunsafe
Sichtbarkeitprotected

Parameter (out)

ParameterBeschreibung
otherThe other object

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01913
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01913@rel:R25-11#b3184885
Content hash
b3184885
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01913
Status: valid/unmigrated Version: rel:R25-11#4c757859 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01913@rel:R25-11#4c757859
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#662a98ac2026-09-30
  • R23-11rel:R23-11#2175e3ea2026-10-14
  • R24-11rel:R24-11#4c7578592026-10-14
  • R25-11rel:R25-11#4c7578592026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция StopOffer [SWS_DM_01925] Upstream: RS_Diag_04265

void StopOffer () const noexcept;

This StopOffer will disable the forwarding of request messages from DM.

СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: dee04ad7b94a Происхождение Открытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Использование

Метод ara::diag::SovdSwUpdate::StopOffer прекращает предложение службы и деактивирует пересылку входящих сообщений-запросов от Diagnostic Management (DM) компоненту обновления программного обеспечения [SWS_DM_01925]. Вызов выполняется через интерфейс из ara/diag/sovd_sw_update.h, не принимает параметров и не возвращает значения [SWS_DM_01925]. Завершение предложения службы происходит синхронно и соответствует концептуальной деактивации диагностических функций в AUTOSAR Adaptive AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

Обработка ошибок и параллелизм

Функция имеет спецификацию noexcept и, таким образом, является исключительной безопасности; состояния ошибки через исключения или коды ошибок не предусмотрены [SWS_DM_01925]. В отношении контекста вызова действует правило: функция определена как непотокобезопасная («not thread-safe») [SWS_DM_01925]. Параллельные вызовы на одном и том же экземпляре должны синхронизироваться на стороне приложения. Интерпретация: повторный вызов StopOffer в уже неактивном состоянии, вероятно, останется без последствий в плане ошибок, поскольку обработка ошибок отсутствует. Вопрос Q-efaccde5507eb444 (открытый)

Взаимодействие

В общей системе функция встраивается в единую схему жизненного цикла служб DM. Она представляет собой функциональный эквивалент предложения службы и ведет себя аналогично операциям деактивации других диагностических служб, таких как ara::diag::DownloadService [SWS_DM_00793], ara::diag::GenericUDSService [SWS_DM_00620], а также ara::diag::EcuResetRequest [SWS_DM_01017].

Этот текст был сгенерирован ИИ на основе спецификации AUTOSAR R25-11.

Руководство разработчика реализации в подготовке (сложность I2)

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
None

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01925
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01925@rel:R25-11#9115646b
Content hash
9115646b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01925
Status: valid/unmigrated Version: rel:R25-11#b5890de5 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01925@rel:R25-11#b5890de5
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#60438b2c2026-09-30
  • R23-11rel:R23-11#aac09bc62026-10-14
  • R24-11rel:R24-11#b5890de52026-10-14
  • R25-11rel:R25-11#b5890de52026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция operator= [SWS_DM_01914] Upstream: RS_Diag_04265

SovdSwUpdate & operator= (SovdSwUpdate const &)=delete;

SovdSwUpdate shall be a single not assignable instance.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Sichtbarkeitprotected

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01914
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01914@rel:R25-11#1c04038b
Content hash
1c04038b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01914
Status: valid/unmigrated Version: rel:R25-11#193efe55 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01914@rel:R25-11#193efe55
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#f93349172026-09-30
  • R23-11rel:R23-11#bd4a8b212026-10-14
  • R24-11rel:R24-11#193efe552026-10-14
  • R25-11rel:R25-11#193efe552026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция operator= [SWS_DM_01915] Upstream: RS_Diag_04265

SovdSwUpdate & operator= (SovdSwUpdate &&other) & noexcept;

Move assigns an instance of SovdSwUpdate.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe
Sichtbarkeitprotected

Parameter (out)

ParameterBeschreibung
otherThe other object

Rückgabewert

TypBeschreibung
SovdSwUpdate &Reference to self

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01915
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01915@rel:R25-11#5db531f1
Content hash
5db531f1
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01915
Status: valid/unmigrated Version: rel:R25-11#1ed1cfe6 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01915@rel:R25-11#1ed1cfe6
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#9f73c1222026-09-30
  • R23-11rel:R23-11#7eb86d6a2026-10-14
  • R24-11rel:R24-11#1ed1cfe62026-10-14
  • R25-11rel:R25-11#1ed1cfe62026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

функция ~SovdSwUpdate [SWS_DM_01911] Upstream: RS_Diag_04265

virtual ~SovdSwUpdate () noexcept;

Destructor of class SovdSwUpdate.

Header-Datei#include "ara/diag/sovd_sw_update.h"
Scopeclass ara::diag::SovdSwUpdate
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01911
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01911@rel:R25-11#96712ac9
Content hash
96712ac9
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01911
Status: valid/unmigrated Version: rel:R25-11#2b411c6a Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01911@rel:R25-11#2b411c6a
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#7b4f357a2026-09-30
  • R23-11rel:R23-11#0a7ddd152026-10-14
  • R24-11rel:R24-11#5ddc97882026-10-14
  • R25-11rel:R25-11#2b411c6a2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill