. While it is a popular legacy choice for hobbyists, it is primarily a community-maintained wrapper that simplifies the process of setting and reading time from the DS1302 chip. Arduino Forum Core Functionality
If your Arduino project needs to track the exact time—even after losing power—you need a Real-Time Clock (RTC) module. The DS1302 is a highly popular, low-cost RTC chip used for this exact purpose. To make this chip talk to your microcontroller easily, developers rely on the library.
Here is an example code snippet that demonstrates how to use the Virtuabotix RTC library:
This means virtuabotixRTC.h is the correct choice for your DS1302 module, as I2C-focused libraries will not work with it. virtuabotixrtc.h arduino library
To read the current time, you must call updateTime() inside your loop before attempting to read the variables:
The library is one of the most popular, lightweight, and user-friendly libraries available for interfacing Arduino boards with Real-Time Clock (RTC) modules. It is specifically optimized for the widely used DS1302 RTC chip.
This occurs if you leave the setDS1302Time() command active in your code. Once the time is initially saved to the module's battery-backed memory, that line should be deleted or commented out. The DS1302 is a highly popular, low-cost RTC
else // Outside working hours: do nothing (or deep sleep) Serial.println("Outside logging hours. Sleeping...");
Before diving into code, it's crucial to know the key distinction:
: updateTime() Fetches the current time data from the DS1302 chip and populates the library's internal variables. Data Access To read the current time, you must call
#include <Wire.h> #include "VirtuabotixRTC.h"
, you can access individual time elements as object members (e.g., myRTC.hours myRTC.minutes Simple Pin Mapping