DEENESPTFRRUARHIKOZHNL

класс apext::phm::WatchdogInterface

[SWS_PHM_01257] Upstream: RS_PHM_00101

class WatchdogInterface {...};

class for interface to hardware watchdog Note: class WatchdogInterface although identifiable in code as an interface, it is a PlatformExtension - i.e. no modelled interface - nothing to do here

Header-Datei#include "apext/phm/watchdog_interface.h"
Forwarding-Header#include "apext/phm/phm_fwd.h"
Scopenamespace apext::phm

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

Подключает управление аппаратным сторожевым таймером и реакцию на ошибки к Platform Health Management.
СОЗДАНО ИИ не проверено Модель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: ead3ce845973 Происхождение Открытые вопросы (3)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал

Подключает управление аппаратным сторожевым таймером и реакцию на ошибки к Platform Health Management.

Класс apext::phm::WatchdogInterface в качестве расширения платформы образует интерфейс между Platform Health Management и физическим аппаратным сторожевым таймером. В штатном режиме PHM циклически уведомляет интерфейс через AliveNotification(), причем интерфейс должен самостоятельно инициировать реакцию сторожевого таймера при отсутствии сообщений [SWS_PHM_01255]. При критических системных ошибках PHM может через FireWatchdogReaction() также напрямую принудительно вызвать реакцию на ошибку со стороны аппаратного сторожевого таймера [SWS_PHM_01256]. В качестве ключевого граничного условия оба метода специфицированы как потокобезопасные, но небезопасные относительно исключений.

Контекст

C++-класс apext::phm::WatchdogInterface представляет собой интерфейс к физическому аппаратному сторожевому таймеру в Platform Health Management (PHM) стандарта AUTOSAR Adaptive. Являясь расширением платформы (PlatformExtension), он не отображает смоделированный интерфейс портов AUTOSAR, а служит зависящим от поставщика мостом между службой PHM и базовым аппаратным обеспечением. PHM контролирует выполнение процессов и компонентов платформы. Чтобы надежно подстраховать также сбой или блокировку самого PHM, WatchdogInterface подключает внешний или внутренний аппаратный мониторинг. С помощью метода AliveNotification() служба PHM циклически сообщает интерфейсу о своей работоспособности [SWS_PHM_01255]. При возникновении критической системной ошибки PHM может целенаправленно запросить аппаратную реакцию на ошибку через функцию FireWatchdogReaction() [SWS_PHM_01256].

WatchdogKontext PHM PHM WatchdogInterface WatchdogInterface PHM->WatchdogInterface AliveNotification() / FireWatchdogReaction() HardwareWatchdog HardwareWatchdog WatchdogInterface->HardwareWatchdog Triggerung / Watchdog-Reaktion

Контекстная диаграмма: интеграция WatchdogInterface между PHM и аппаратным сторожевым таймером. Источники: [SWS_PHM_01255], [SWS_PHM_01256]

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

Поскольку apext::phm::WatchdogInterface функционирует как расширение платформы, инстанцирование реализации интерфейса и подключение к драйверу оборудования, вероятно, происходят аппаратно-зависимым образом во время инициализации службы PHM. Вопрос Q-c2235d5c87e0a675 (открытый) Время жизни экземпляра обычно привязано ко времени работы PHM, поэтому динамический жизненный цикл с многократным созданием или уничтожением во время работы платформы не предусмотрен. В отношении параллелизма обе интерфейсные функции AliveNotification() и FireWatchdogReaction() явно объявлены как потокобезопасные (thread-safe) [SWS_PHM_01255], [SWS_PHM_01256]. Это позволяет PHM передавать сигналы жизнедеятельности и сообщения об ошибках из различных внутренних рабочих потоков параллельно и без синхронизации на стороне вызывающего объекта в интерфейс сторожевого таймера.

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

Типичное взаимодействие между PHM и интерфейсом подразделяется на регулярный цикл мониторинга и эскалацию ошибок:

  • Циклическая отправка сигналов жизнедеятельности: PHM периодически вызывает AliveNotification() в пределах сконфигурированного времени цикла [SWS_PHM_01255]. Это время цикла не обязательно должно совпадать с реальным периодом срабатывания (триггера) оборудования; вероятно, реализация внутренне буферизует или масштабирует интервалы для управления физическим сторожевым таймером [SWS_PHM_01255]. Вопрос Q-a6c08f102f09c8c1 (открытый)
  • Аппаратный триггер: при регулярных сообщениях WatchdogInterface обеспечивает своевременное обслуживание блока аппаратного сторожевого таймера.
  • Целенаправленная индикация ошибки: если PHM обнаруживает неустранимое состояние (unrecoverable) в контролируемых сущностях, он немедленно вызывает FireWatchdogReaction() [SWS_PHM_01256].
Циклический контроль и срабатывание реакции сторожевого таймераPHMWatchdogInterfaceHardware-WatchdogUse Case: Регулярный цикл контроляloopKonfigurierte ZykluszeitAliveNotification()Hardware-Watchdog bedienenUse Case: FehlerfallaltPHM fordert Fehlerreaktion anFireWatchdogReaction()Инициировать реакцию сторожевого таймераСообщение о работоспособности (alive) отсутствует (тайм-аут)Timeout erkennenИнициировать реакцию сторожевого таймера

Диаграмма последовательности: регулярная передача сигналов жизнедеятельности и запуск реакции сторожевого таймера. Источники: [SWS_PHM_01255], [SWS_PHM_01256]

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

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

С одной стороны, пассивное отсутствие сообщений приводит к реакции системы: если PHM не отправляет подтверждение через AliveNotification() в течение сконфигурированного периода времени, WatchdogInterface обязан самостоятельно инициировать реакцию сторожевого таймера [SWS_PHM_01255]. Благодаря этому сбои или взаимные блокировки (deadlocks) самой службы PHM надежно перехватываются оборудованием.

С другой стороны, существует активный путь обработки ошибок: посредством явного вызова FireWatchdogReaction() запускается определенная реакция сторожевого таймера на ошибку [SWS_PHM_01256]. В обоих случаях итоговое воздействие на системном уровне, вероятно, обычно заключается в аппаратном сбросе (reset) или переводе в безопасное состояние. Вопрос Q-817baa072cc94a19 (открытый)

Что касается поведения при ошибках в коде, обе функции-члена специфицированы как небезопасные относительно исключений (not exception safe) [SWS_PHM_01255], [SWS_PHM_01256]. Таким образом, вызывающий компонент не может опираться на гарантии обработки исключений, а реализация интерфейса не должна генерировать необработанные C++-исключения.

Данное руководство обобщает спецификацию apext::phm::WatchdogInterface согласно AUTOSAR Adaptive R25-11.

UML-диаграмма классов

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

G napext__phm__WatchdogInterface47 WatchdogInterface + AliveNotification() + FireWatchdogReaction()

Методы

AliveNotification функция

Called cyclically by PHM in configurable cycle time. Note: This time might differ from the cycle time of triggering the "real" hardware watchdog. If PHM does not report aliveness in configured time, WatchdogInterface shall initiate watchdog reaction

void AliveNotification ();
FireWatchdogReaction функция

Interface to fire an error reaction of the Watchdog.

void FireWatchdogReaction ();

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

функция AliveNotification [SWS_PHM_01255] Upstream: RS_PHM_00101, RS_PHM_09240

void AliveNotification ();

Called cyclically by PHM in configurable cycle time. Note: This time might differ from the cycle time of triggering the "real" hardware watchdog. If PHM does not report aliveness in configured time, WatchdogInterface shall initiate watchdog reaction

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

Функция AliveNotification из заголовочного файла apext/phm/watchdog_interface.h принадлежит классу apext::phm::WatchdogInterface и служит для циклического мониторинга жизнеспособности Platform Health Management (PHM) [SWS_PHM_01255]. Интерфейс имеет сигнатуру void AliveNotification(), не принимает параметров и не возвращает значения [SWS_PHM_01255].

Контекст вызова и временные характеристики

Вызов AliveNotification выполняется периодически модулем PHM с настраиваемым временем цикла [SWS_PHM_01255]. Эта частота вызовов логически отделена от управления фактическим физическим аппаратным сторожевым таймером, поэтому сконфигурированный период PHM может отличаться от времени триггера аппаратного сторожевого таймера [SWS_PHM_01255].

Реакция на ошибки и сценарии сбоев

Если PHM не сообщает успешно о своей жизнеспособности в пределах настроенного для этого интервала времени, WatchdogInterface предписано инициировать реакцию сторожевого таймера [SWS_PHM_01255]. Специфические коды ошибок не предусмотрены. Интерпретация: поскольку интерфейс классифицирован как не обладающий безопасностью относительно исключений, непредвиденные ошибочные состояния, вероятно, распространяются в контекст вызывающей стороны в виде C++-исключений [SWS_PHM_01255]. Вопрос Q-a9e59a992db9913f (открытый)

Параллелизм и безопасность исключений

Функция специфицирована как потокобезопасная (thread-safe), поэтому параллельный доступ разрешён, однако она считается не обеспечивающей безопасность относительно исключений (not exception safe) [SWS_PHM_01255].

Этот текст был создан ИИ и обобщает состояние спецификации AUTOSAR Adaptive R25-11.

Header-Datei#include "apext/phm/watchdog_interface.h"
Scopeclass apext::phm::WatchdogInterface
Exception-Sicherheitnot exception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_PHM_01255
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PHM_01255@rel:R25-11#952d89cc
Content hash
952d89cc
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01255
Status: valid/unmigrated Version: rel:R25-11#3204f230 Versionshistorie & Revisions (1 transition, 3 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_PHM_01255@rel:R25-11#3204f230
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#756ef89a2026-09-30
  • R24-11rel:R24-11#b0affe0c2026-10-14
  • R25-11rel:R25-11#3204f2302026-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

функция FireWatchdogReaction [SWS_PHM_01256] Upstream: RS_PHM_00101

void FireWatchdogReaction ();

Interface to fire an error reaction of the Watchdog.

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

Функция FireWatchdogReaction служит выделенным интерфейсом внутри модуля Platform Health Management (PHM) для целенаправленного запуска реакции сторожевого таймера на ошибку [SWS_PHM_01256]. Она относится к области видимости класса apext::phm::WatchdogInterface и предоставляется через заголовочный файл apext/phm/watchdog_interface.h [SWS_PHM_01256].

При использовании необходимо учитывать следующие аспекты:

  • Вызов и интерфейс: обладая сигнатурой void FireWatchdogReaction ();, функция не принимает входных параметров и не возвращает значения [SWS_PHM_01256]. Вызов непосредственно инициирует реакцию сторожевого таймера на ошибку.
  • Параллелизм: операция специфицирована как thread-safe [SWS_PHM_01256]. Следовательно, её разрешено вызывать параллельно из нескольких потоков без дополнительной внешней синхронизации.
  • Безопасность относительно исключений и обработка ошибок: функция объявлена как not exception safe [SWS_PHM_01256]. Интерпретация: поскольку безопасность относительно исключений не гарантируется, возникающие в случае сбоя исключения, вероятно, распространяются напрямую вызывающей стороне, ввиду чего она должна быть готова к возможным исключениям. Вопрос Q-f53d689332369cd7 (открытый)

Таким образом, функция предоставляет стандартизированную точку доступа для активного вмешательства в поведение сторожевого таймера при критических ошибках и запуска определённых защитных мер [SWS_PHM_01256].

Этот текст сгенерирован ИИ. Он основан на AUTOSAR Adaptive R25-11.

Header-Datei#include "apext/phm/watchdog_interface.h"
Scopeclass apext::phm::WatchdogInterface
Exception-Sicherheitnot exception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_PHM_01256
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PHM_01256@rel:R25-11#dc34be99
Content hash
dc34be99
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01256
Status: valid/unmigrated Version: rel:R25-11#9d382947 Versionshistorie & Revisions (1 transition, 3 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_PHM_01256@rel:R25-11#9d382947
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#8b20aac12026-09-30
  • R24-11rel:R24-11#e80c13872026-10-14
  • R25-11rel:R25-11#9d3829472026-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