Описание
Библиотека позволяет читать и записывать время RTC модулей на базе чипов: DS1302, DS1307, DS3231, ...
Преимуществом данной библиотеки является удобная реализация получения времени.
Данная библиотека может использовать как аппаратную, так и программную реализацию шины I2C.
О том как выбрать тип шины I2C рассказано в статье Wiki - расширенные возможности библиотек iarduino для шины I2C.
Подробное описание работы с библиотекой, находится в разделе Wiki - Часы реального времени.
Назначение функций и переменных:
#include <iarduino_RTC.h> // Подключаем библиотеку.
iarduino_RTC ОБЪЕКТ ( [&ШИНА], НАЗВАНИЕ [,RST [,CLK [,DAT ]]] ); // Создаём объект.
Функция begin(); // Инициализация работы RTC модуля.
Функция settime( СЕК [,МИН [,ЧАС [,ДЕНЬ [,МЕС [,ГОД [,ДН ]]]]]] ); // Установка времени.
Функция gettime( [СТРОКА_ШАБЛОН] ); // Чтение времени.
Функция blinktime( ПАРАМЕТР [,ЧАСТОТА] ); // Параметр времени будет мигать.
Функция period( МИНУТЫ ); // Минимальный период обращения к модулю в минутах.
Функция settimeUnix( СЕКУНДЫ ); // Установка времени Unix time.
Функция gettimeUnix(); // Чтение времени Unix time.
При любом обращении к функциям gettime() и gettimeUnix(), автоматически обновляются значения следующих переменных:
Переменная seconds // Содержит секунды от 0 до 59.
Переменная minutes// Содержит минуты от 0 до 59.
Переменная hours // Содержит часы от 1 до 12.
Переменная Hours // Содержит часы от 0 до 23.
Переменная midday // Содержит полдень 0 или 1 (0-am, 1-pm).
Переменная day // Содержит день месяца от 1 до 31.
Переменная weekday // Содержит день недели от 0 до 6 (0-воскресенье, 6-суббота).
Переменная month // Содержит месяц от 1 до 12.
Переменная year // Содержит год от 0 до 99.
Переменная Unix // Содержит секунды с начала эпохи Unix, от 0 до 4'294'967'295.
_________________________________
Функции settimeUnix(), gettimeUnix() и переменная Unix доступны в библиотеке версии 1.3.4 и выше.