/**
 * @file watchdog.h
 * @brief APP 独立看门狗模块（FWDGT）。
 *
 * 超时后系统硬复位，BOOT 检测 FWDGT 复位标志后停留在 OTA 等待模式，
 * 而非继续跳入卡死的 APP。
 */
#ifndef DEVICE_WATCHDOG_H
#define DEVICE_WATCHDOG_H

#include <stdint.h>

class Watchdog {
public:
    /** init 故障码（0=成功；经 0xA3 INIT_STATUS fault_codes[] 上报） */
    enum InitFault : uint8_t {
        kFaultOk          = 0U, /**< 成功 */
        kFaultPsc         = 1U, /**< 预分频写入未被硬件确认（PUD 超时） */
        kFaultRld         = 2U, /**< 重载值写入未被硬件确认（RUD 超时） */
        kFaultPending     = 3U, /**< 使能后仍有挂起的配置更新（PUD/RUD 未清零） */
        kFaultLsiNotReady = 4U, /**< LSI(IRC40K) 使能后稳定等待超时 */
    };

    /** @brief 初始化并启动 FWDGT，超时约 CONFIG_FWDGT_TIMEOUT_MS 毫秒。
     *  @retval uint8_t InitFault 故障码（0=PSC/RLD 写入均经硬件确认且无挂起更新）。 */
    static uint8_t init();

    /** @brief 喂狗（重载计数器），应在主循环中周期调用。 */
    static void feed();
};

#endif /* DEVICE_WATCHDOG_H */