Files
IoTManager/lib/iarduino_RTC/README.md

105 lines
5.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
[![](https://iarduino.ru/img/logo.svg)](https://iarduino.ru)[![](https://wiki.iarduino.ru/img/git-shop.svg?3)](https://iarduino.ru) [![](https://wiki.iarduino.ru/img/git-wiki.svg?2)](https://wiki.iarduino.ru) [![](https://wiki.iarduino.ru/img/git-lesson.svg?2)](https://lesson.iarduino.ru)[![](https://wiki.iarduino.ru/img/git-forum.svg?2)](http://forum.trema.ru)
# iarduino_RTC [СКАЧАТЬ](https://github.com/tremaru/iarduino_RTC/archive/1.2.1.zip)
Библиотека позволяет читать и записывать время RTC модулей на базе чипов: DS1302, [DS1307](http://iarduino.ru/shop/Expansion-payments/chasy-realnogo-vremeni-rtc-trema-modul.html), [DS3231](http://iarduino.ru/shop/Expansion-payments/chasy-realnogo-vremeni-rtc-trema-modul-v2-0.html), ...
Преимуществом данной библиотеки является удобная реализация получения времени.
> Подробнее про установку библиотеки читайте в нашей [инструкции](https://wiki.iarduino.ru/page/Installing_libraries/).
Пример подключения к [Arduino](https://iarduino.ru/shop/boards/arduino-uno-r3.html)/[Piranha UNO](https://iarduino.ru/shop/boards/piranha-uno-r3.html) с помощью [Trema Shield](https://iarduino.ru/shop/Expansion-payments/trema-shield.html)
Подробнее о [подключении модуля](https://wiki.iarduino.ru/page/chasy-realnogo-vremeni-rtc-trema-modul/)
![enter image description here](https://iarduino.ru/img/upload/6a83fe7f3deb2f48d1408daac49284ba.png)
| Модель | Ссылка на магазин|
|--|--|
| DS1307 ![enter image description here](https://wiki.iarduino.ru/img/resources/643/643.svg) | https://iarduino.ru/shop/Expansion-payments/chasy-realnogo-vremeni-rtc-trema-modul.html|
| DS3231 ![enter image description here](https://wiki.iarduino.ru/img/resources/877/877.svg) | https://iarduino.ru/shop/Expansion-payments/chasy-realnogo-vremeni-rtc-trema-modul-v2-0.html |
## Описание библиотеки:
Библиотека позволяет читать и записывать время RTC модулей на базе чипов: DS1302, [DS1307](http://iarduino.ru/shop/Expansion-payments/chasy-realnogo-vremeni-rtc-trema-modul.html), [DS3231](http://iarduino.ru/shop/Expansion-payments/chasy-realnogo-vremeni-rtc-trema-modul-v2-0.html), …
Преимуществом данной библиотеки является удобная реализация получения времени.
**[ Подробное описание, подключение и примеры работы ](https://wiki.iarduino.ru/page/chasy-realnogo-vremeni-rtc-trema-modul/)**
## Назначение функций и переменных:
Подробное описание работы с библиотекой, находится в разделе https://wiki.iarduino.ru/page/chasy-realnogo-vremeni-rtc-trema-modul/
**Подключаем библиотеку.**
#include <iarduino_RTC.h> // Подключаем библиотеку.
**Создаём объект.**
iarduino_RTC ОБЪЕКТ ( НАЗВАНИЕ [, ВЫВОД_RST [, ВЫВОД_CLK [, ВЫВОД_DAT ]]] ); // Создаём объект.
**Инициализация работы RTC модуля.**
Функция begin(); // Инициализация работы RTC модуля.
**Установка времени.**
Функция settime( СЕК [, МИН [, ЧАС [, ДЕНЬ [, МЕС [, ГОД [, ДН ]]]]]] ); // Установка времени.
**Чтение времени.**
Функция gettime( [ СТРОКА ] ); // Чтение времени.
**Заставляет функцию gettime «мигать» указанным параметром времени.**
функция blinktime( ПАРАМЕТР [ ЧАСТОТА ] ); // Заставляет функцию gettime «мигать» указанным параметром времени.
**Указывает минимальный период обращения к модулю в минутах.**
функция period( МИНУТЫ ); // Указывает минимальный период обращения к модулю в минутах.
**Возвращает секунды от 0 до 59.**
Переменная seconds // Возвращает секунды от 0 до 59.
**Возвращает минуты от 0 до 59.**
Переменная minutes // Возвращает минуты от 0 до 59.
**Возвращает часы от 1 до 12.**
Переменная hours // Возвращает часы от 1 до 12.
**Возвращает часы от 0 до 23.**
Переменная Hours // Возвращает часы от 0 до 23.
**Возвращает полдень 0 или 1 (0-am, 1-pm).**
Переменная midday // Возвращает полдень 0 или 1 (0-am, 1-pm).
**Возвращает день месяца от 1 до 31.**
Переменная day // Возвращает день месяца от 1 до 31.
**Возвращает день недели от 0 до 6 (0-воскресенье, 6-суббота).**
Переменная weekday // Возвращает день недели от 0 до 6 (0-воскресенье, 6-суббота).
**Возвращает месяц от 1 до 12.**
Переменная month // Возвращает месяц от 1 до 12.
**Возвращает год от 0 до 99.**
Переменная year // Возвращает год от 0 до 99.