ISleepController.h

Go to the documentation of this file.

#pragma once
 
#include "cdc_core/IService.h"
#include <cstdint>
 
namespace cdc::hal {

enum class SleepMode : uint8_t {
    NONE,           // Not sleeping
    LIGHT_SLEEP,    // CPU paused, peripherals active, fast wake
    DEEP_SLEEP      // Full power down, causes reset on wake
};

enum class WakeupSource : uint8_t {
    UNKNOWN,
    TIMER,          // Timer wakeup
    GPIO,           // GPIO wakeup (keypad)
    TOUCHPAD,       // Touch wakeup
    EXT0,           // EXT0 wakeup
    EXT1            // EXT1 wakeup
};

using SleepCallback = void (*)(void* context);

struct SleepCallbackEntry {
    const char* moduleName;     // For debugging/unregister
    SleepCallback callback;
    void* context;
    uint8_t priority;           // Lower = called first (0-255)
};

class ISleepController : public core::IService {
public:
    virtual ~ISleepController() = default;

    virtual void enterLightSleep() = 0;

    [[noreturn]] virtual void enterDeepSleep() = 0;

    virtual WakeupSource getWakeupSource() const = 0;

    virtual bool wasInDeepSleep() const = 0;

    virtual void clearDeepSleepFlag() = 0;

    virtual void setLightSleepInterval(uint32_t seconds) = 0;

    virtual uint32_t getLightSleepInterval() const = 0;

    virtual void prepareGpioForSleep() = 0;

    virtual void stabilizeGpioAfterWakeup() = 0;
 
    // === Callback Registration ===

    virtual bool registerPreSleepCallback(const SleepCallbackEntry& entry) = 0;

    virtual bool registerWakeupCallback(const SleepCallbackEntry& entry) = 0;

    virtual void unregisterCallbacks(const char* moduleName) = 0;
};
 
// Factory function
ISleepController* getSleepControllerInstance();
 
} // namespace cdc::hal