Универсальная библиотека iarduino_RTC для RTC DS1302, DS1307, DS3231 к Arduino

Библиотека позволяет читать и записывать время 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 и выше.