rtc.h

Go to the documentation of this file.

#pragma once
 
#include "ersa/common/types.h"
#include <stdint.h>
 
namespace ersa {
namespace hal {
 
struct TimePoint {
    uint16_t year{2026};
    uint8_t month{9};
    uint8_t day{28};
    uint8_t hour{0};
    uint8_t minute{0};
    uint8_t second{0};
    uint8_t dayOfWeek{1}; // 0 = Sunday, 1 = Monday, ... 6 = Saturday
    uint32_t epoch{0};
 
    constexpr TimePoint() = default;
    constexpr TimePoint(uint16_t y, uint8_t m, uint8_t d, uint8_t h, uint8_t min, uint8_t s, uint8_t dow = 0, uint32_t ep = 0)
        : year(y), month(m), day(d), hour(h), minute(min), second(s), dayOfWeek(dow), epoch(ep) {}
};
 
struct RtcDiagnostics {
    TimePoint time{};
    TimePoint chipTime{};
    bool hardwareReadable{false};
    bool oscillatorStopped{false};
    bool driftMeasured{false};
    int32_t driftSeconds{0};
};
 
class IRtc {
public:
    virtual ~IRtc() = default;
 
    virtual Result<void> init() = 0;
    virtual TimePoint now() = 0;
    virtual Result<void> adjust(const TimePoint& time) = 0;
    virtual Result<void> setEpoch(uint32_t epochSeconds) = 0;
    virtual bool isHealthy() const = 0;
    virtual RtcDiagnostics diagnostics() {
        RtcDiagnostics result{};
        result.time = now();
        result.chipTime = result.time;
        result.hardwareReadable = isHealthy();
        return result;
    }
    virtual void resync() {}
};
 
} // namespace hal
} // namespace ersa