Virtuabotixrtc.h Arduino Library ((top)) Jun 2026

The DS1302 is an integrated circuit that acts like a digital wristwatch for microcontrollers. Unlike the standard internal clock of an Arduino—which resets whenever power is lost—the DS1302 often features a and a dedicated crystal oscillator. This hardware ensures that the device maintains accurate time (seconds, minutes, hours, days, months, and years) even when the main system is powered down. Functionality of virtuabotixRTC.h

However, it's important to note that the DS1302's quartz crystal is external, which can sometimes lead to time drift issues (the clock running fast or slow). For projects requiring extreme precision, a higher-end chip like the DS3231, which has a built-in temperature-compensated crystal, is often recommended. The DS3231 is much more accurate compared to the DS1307 and DS1302.

void loop() // Your main code here

// CLK, DAT, RST virtuabotixRTC myRTC(6, 7, 8); virtuabotixrtc.h arduino library

While the VirtuabotixRTC library excels at its core task, the Arduino ecosystem offers other robust options, particularly .

void setup() pinMode(relayPin, OUTPUT);

Unlike the more modern RTClib by Adafruit (which is excellent for DS3231 and DS1307 over I2C), the Virtuabotix library handles the unique to the DS1302. This is crucial because the DS1302 uses a different communication method than standard I2C or SPI devices.

The library manages time by updating specific object variables. It does not require complex data structures to read or write time values. Core Variables myRTC.seconds — Tracks current seconds (0-59) myRTC.minutes — Tracks current minutes (0-59) myRTC.hours — Tracks current hours (0-23) myRTC.dayofWeek — Tracks day numerical value (1-7) myRTC.dayofMonth — Tracks calendar day (1-31) myRTC.month — Tracks current month (1-12) myRTC.year — Tracks four-digit calendar year Essential Methods The DS1302 is an integrated circuit that acts

If you want, I can:

void loop() myRTC.updateTime(); // This line is crucial! It updates the variables below.

// Define the pins used to connect the RTC module const int rtcClockPin = 2; const int rtcDataPin = 3; const int rtcCsPin = 4;

A typical use case is a greenhouse data logger. The following snippet demonstrates how one might log temperature every hour: Functionality of virtuabotixRTC

myRTC.updateTime();

Manages seconds, minutes, hours, day of the week, date of the month, month, and year. Automatic leap-year compensation valid up to the year 2100.