/uRTCLib

Really tiny library to basic RTC functionality on Arduino. DS1307, DS3231 and DS3232 RTCs are supported.

Primary LanguageC++GNU Lesser General Public License v3.0LGPL-3.0

Arduino, ESP8266, STM32, ESP32 and others uRTCLib

Master status: Build Status

What is this repository for?

Really tiny library to basic RTC functionality on Arduino, ESP8266, STM32, ESP32 and other microcontrollers.

DS1307, DS3231 and DS3232 RTCs are supported (and compatibles)

Supported features:

  • SQuare Wave Generator
  • Fixed output pin for DS1307
  • RAM for DS1307 and DS3232
  • temperature sensor for DS3231 and DS3232
  • Alarms (1 and 2) for DS3231 and DS3232
  • Power lost flag reading and clearing

EEPROM support has been moved to https://github.com/Naguissa/uEEPROMLib

How do I get set up?

You can get it from Arduino libraries directly, searching by uRTCLib.

For manual installation:

  • Get the ZIP.
  • Rename to uRTCLib.zip
  • Install library on Arduino

Documentation and extras

You can find all documentation and extras in this repository: https://github.com/Naguissa/uRTCLib_doc_and_extras

You can read documentation online here: https://naguissa.github.io/uRTCLib_doc_and_extras/

Examples

Included on example folder, available on Arduino IDE.

Important notes

  • Check .h file to see all constants and per-model limitations
  • Alarm pin is normaly HIGH and turns LOW when active.
  • When using alarms, you need to clear the alarm flag manually using alarmClearFlag(). If not done alarm maintains its LOW state.
  • When using alarms SQWG is turned off. When using SQWG alarms are turned off. They're mutually excluding.

Who do I talk to?

Contribute

Any code contribution, report or comment are always welcome. Don't hesitate to use GitHub for that.

Thanks for your support.

Contributors hall of fame: https://www.foroelectro.net/hall-of-fame-f32/contributors-contribuyentes-t271.html