// наследует StampTicker

// передать период синхронизации в секундах, умолч. 1 час
GyverDS3231(uint16_t syncPrd = 60 * 60);

// запустить и синхронизировать. Можно указать другой драйвер Wire и i2c адрес. Вернёт true при успехе
bool begin(TwoWire* wire = &Wire, uint8_t addr = 0x68);

// RTC работает корректно (чтение и валидация времени)
bool isOK();

// синхронизировать время с RTC. true при успехе, false при ошибке шины или после сброса питания RTC
bool updateNow();

// прочитать время с RTC для отладки
Datime getTime();

// установить время RTC равным локальному времени компиляции прошивки
bool setBuildTime();

// установить время RTC:
// ("hh:mm:ss") или ("yyyy-mm-dd") или ("yyyy-mm-ddThh:mm:ss")
// (unix)
// Datime(year, month, day, hour, minute, second)
bool setTime(Datime dt);

// тикер, вызывать в loop. Возвращает true каждую секунду, если время синхронизировано
bool tick();

// получить температуру чипа
float getTemp();

// получить температуру чипа
int getTempInt();

// получить смещение калибровки (значение * 0.1ppm)
int8_t getOffset();

// установить смещение калибровки (значение * 0.1ppm)
bool setOffset(int8_t offset);

#include <GyverDS3231.h>
GyverDS3231 ds;

void setup() {
    setStampZone(3);  // указать часовой пояс, если в программе нужен реальный unix
    // если не нужен - можно не указывать (останется 0)

    Serial.begin(115200);
    Wire.begin();

    // запустить и синхронизировать время, если возможно
    ds.begin();

    // запустить на другом драйвере I2C
    // ds.begin(&customWire);

    // ИЛИ
    // если старт неудачный (например был сброс питания RTC)
    // установить время равным времении компиляции
    // if (!ds.begin()) ds.setBuildTime();

    // установка времени вручную
    // ds.setTime(123456789ul);                     // unix
    // ds.setTime(Datime(2024, 7, 27, 17, 6, 30));  // Y.M.D H:M:S
    
    // Datime dt;
    // dt.second = 34;
    // ...задать дату и время...
    // и отправить в RTC
    // ds.setTime(dt);
}

void loop() {
    // вызывать тикер в loop
    // тикер также вернёт true каждую секунду, что удобно для сравнения времени
    if (ds.tick()) {
        Serial.println(ds.toString());     // вывод даты и времени строкой
        Serial.println(ds.dateToString()); // вывод даты строкой

        // можно сравнивать напрямую с unix
        if (ds >= 12345) { }
        if (ds == 123456) { }

        ds.getUnix();  // получить unix секунды

        // парсинг unix на дату и время
        ds.second();   // секунды
        ds.minute();   // минуты и так далее

        // эффективнее использовать парсер Datime
        Datime dt(ds);  // ds само конвертируется в Datime

        dt.year;
        dt.month;
        dt.day;
        dt.hour;
        dt.minute;
        dt.second;
        dt.weekDay;
        dt.yearDay;

        // для автоматизации внутри суток удобно использовать 
        // секунды с начала суток, daySeconds()
        ds.daySeconds();

        // для удобства также есть класс DaySeconds, позволяющий задать время внутри суток
        DaySeconds dsec(5, 10, 0);  // 5 часов, 10 минут, 0 секунд

        // GyverDS3231 может сравниваться напрямую с DaySeconds
        if (ds == dsec) { }
    }
}