SystemLock.h

Go to the documentation of this file.

#pragma once
 
#include <atomic>
#include <cstdint>
 
namespace cdc::core {

enum class LockdownReason : uint8_t {
    NONE = 0,
    TR01_ALARM_MODE,    
    TR01_UNREACHABLE,   
    TR01_INIT_FAILED,   
    NVS_UNREADABLE,     
};

class SystemLock {
public:
    using ShutdownHandler = void (*)(LockdownReason reason, const char* detail);
 
    static SystemLock& instance();

    bool isLocked() const { return locked_.load(std::memory_order_acquire); }

    LockdownReason getReason() const { return reason_.load(std::memory_order_acquire); }

    const char* getDetail() const { return detail_.load(std::memory_order_acquire); }

    void triggerLockdown(LockdownReason reason, const char* detail = nullptr);

    void setShutdownHandler(ShutdownHandler handler);

    void enforceIfLocked();
 
private:
    SystemLock() = default;
    [[noreturn]] void performShutdown();
 
    std::atomic<bool> locked_{false};
    std::atomic<LockdownReason> reason_{LockdownReason::NONE};
    std::atomic<const char*> detail_{nullptr};
    std::atomic<ShutdownHandler> handler_{nullptr};
};
 
} // namespace cdc::core