функция Clear [SWS_DM_00671] Upstream: RS_AP_00119, RS_AP_00139, RS_Diag_04194
ara::core::Future< void > Clear (std::uint32_t dtcGroup) noexcept;
Method for Clearing a DTC or a group of DTCs.
Метод Clear класса ara::diag::DTCInformation ([SWS_DM_00671]) служит для удаления отдельного DTC или группы DTC в памяти неисправностей (AUTOSAR_AP_SWS_Diagnostics §7.3.2.8.6 «Service 0x14 – ClearDiagnosticInformation»). В качестве параметра он принимает через dtcGroup идентификатор удаляемой группы или DTC и возвращает результат асинхронно как ara::core::Future<void> ([SWS_DM_00671]). Полномочия на удаление отдельных DTC или групп при этом подчиняются параметрам конфигурации, таким как clearDtcLimitation ([SWS_DM_00160]).
Обработка ошибок и семантика
Функция объявлена как noexcept и сообщает об ошибках асинхронно через Future с семантикой отката ([SWS_DM_00671]). Возможные коды ошибок из DiagErrc:
DiagErrc::kBusy: интерфейс уже занят обработкой.DiagErrc::kFailed: при выполнении возникла общая ошибка обработки.DiagErrc::kMemoryError: во время обработки произошла ошибка памяти.DiagErrc::kWrongDtc: передан недопустимый номер DTC.DiagErrc::kServiceNotAvailable: основные функции Diagnostic Manager в данный момент недоступны.
Параллелизм и разграничение
Метод является исключениебезопасным (exception safe), однако явно классифицирован как not thread-safe ([SWS_DM_00671]). Поэтому параллельные вызовы на одном и том же экземпляре должны синхронизироваться вызывающей стороной, иначе грозит DiagErrc::kBusy. Интерпретация: возвращенный ara::core::Future, вероятно, будет выполнен только тогда, когда физическая память неисправностей будет полностью очищена, аналогично квитированию службы UDS 0x14 ([SWS_DM_00162]). Вопрос Q-b97545b6864b24aa (открытый)
Функционально эту операцию следует отличать от одноименных методов SOVD: в то время как ara::diag::DiagnosticSovdContentElementDataView::Clear ([SWS_DM_02233]) очищает контейнеры данных синхронно и потокобезопасно, этот метод управляет диагностическими процессами в Diagnostic Management.
Это указание по использованию было подготовлено ИИ и основано исключительно на выдержках из спецификации AUTOSAR AP релиза R25-11.
Руководство разработчика реализации в подготовке (сложность I1)
| Header-Datei | #include "ara/diag/dtc_information.h" |
|---|---|
| Scope | class ara::diag::DTCInformation |
| Exception-Sicherheit | exception safe |
| Thread-Sicherheit | not thread-safe DiagErrc::kBusy rollback_semantics |
Parameter (in)
| Parameter | Beschreibung |
|---|---|
| dtcGroup | DTC group to be cleared. |
Rückgabewert
| Typ | Beschreibung |
|---|---|
| ara::core::Future< void > | void or errors |
Fehler
| Fehlercode | Beschreibung |
|---|---|
| Interface is busy with processing. | |
| DiagErrc::kFailed | rollback_semantics Failed to process. |
| DiagErrc::kMemoryError | rollback_semantics A memory error occurred during processing. |
| DiagErrc::kWrongDtc | rollback_semantics A wrong DTC number was requested. |
| DiagErrc::kServiceNotAvailable | rollback_semantics The call cannot be executed, because essential DM functionality is currently not available. |
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/SWS_DM_00671- Status
- valid/unmigrated
- Version
AUTOSAR/AP/record/SWS_DM_00671@rel:R25-11#6036a354- Content hash
6036a354- Source
- https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00671
Status: valid/unmigrated
Version: rel:R25-11#5f2d812c
Versionshistorie & Revisions (1 transition, 8 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_00671@rel:R25-11#5f2d812c
Recorded Revisions (8):
- R25-11
rel:R25-11#eeae02f92026-09-30 - R19-11
rel:R19-11#51e8d4512026-10-14 - R20-11
rel:R20-11#a949cf792026-10-14 - R21-11
rel:R21-11#a949cf792026-10-14 - R22-11
rel:R22-11#a1f423932026-10-14 - R23-11
rel:R23-11#cc3a92472026-10-14 - R24-11
rel:R24-11#ee42b6492026-10-14 - R25-11
rel:R25-11#5f2d812c2026-10-14 active
Requirement Text as-of this release:
Curation Decisions:
Reachable Artifacts & Dependents:
| Date | Actor | Transition | Reason / Rationale | Campaign |
|---|---|---|---|---|
| 2026-08-13 | tool | none → valid/unmigrated | mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record | 2026-08-13-status-backfill |
gemini-3.8-flash-low· 2026-10-13 · Немецкий оригинал