Function scopedWatchdogFirstInit

src/fl/wdt/watchdog.cpp.hpp:129–150

First-init helper, used by ScopedWatchdog's constructor. Runs only once per process. Single-threaded loop() is the canonical caller — no atomics are needed for the guard byte on supported MCUs.

// per process. Single-threaded loop() is the canonical caller — no atomics
// are needed for the guard byte on supported MCUs.
inline void scopedWatchdogFirstInit(fl::u32 timeout_ms) FL_NOEXCEPT {
    Watchdog& wdt = Watchdog::instance();
    wdt.begin(timeout_ms);

    ResetInfo info = wdt.lastResetInfo();
    if (info.cause == ResetCause::WATCHDOG ||
        info.cause == ResetCause::PANIC    ||
        info.cause == ResetCause::LOCKUP) {
        char buf[128];
        fl::size n = info.describe(fl::span<char>(buf, sizeof(buf)), /*verbose=*/true);
        scopedWatchdogPrintLine(fl::string_view("[FastLED.watchdog] recovered from:"));
        scopedWatchdogPrintLine(fl::string_view(buf, n));

        if (wdt.hasCrashReport()) {
            // Hook for Tier 2 platforms. Future revision: also emit a
            // multi-line CrashReport::describe() result here. For now the
            // bare cause + raw register is the documented contract.
        }
        scopedWatchdogPause3s();
    }
    scopedWatchdogPrintLine(fl::string_view("[FastLED.watchdog] armed via FL_WATCHDOG_AUTO()"));
}

} // namespace platforms