Enter the virtuabotixrtc.h library. Created to simplify the complex communication protocols (SPI and I2C) used by these RTC chips, this library has become a go-to solution for thousands of makers. This article provides a deep dive into everything you need to know about the virtuabotixrtc.h library—from installation and wiring to advanced coding techniques and troubleshooting.
The VirtuabotixRTC library is not available through the default Arduino Library Manager. You must manually install it from a ZIP file.
While the official Arduino RTC library exists, the Virtuabotix version gained popularity because of its simplicity and its ability to handle the quirky timing protocols of the DS1302. The library handles the low-level bit-banging necessary to read and write time data, allowing you to use simple commands like rtc.getTimeStr() or rtc.setDate() . virtuabotixrtc.h arduino library
April 11, 2026 Library version referenced: 1.0.0 (as available in Arduino Library Manager)
void setup() Wire.begin(); // Set time once (uncomment and adjust values then upload) // rtc.setDS1307Time(30, 59, 23, 7, 24, 3, 2026); // sec,min,hour,day,date,month,year Enter the virtuabotixrtc
This means virtuabotixRTC.h is the correct choice for your DS1302 module, as I2C-focused libraries will not work with it.
void loop() // This is the most important line. It reads the RTC's current time // into the library's variables. myRTC.updateTime(); The VirtuabotixRTC library is not available through the
lcd.setCursor(0, 1); lcd.print("Date:"); lcd.print(myRTC.month); lcd.print("/"); lcd.print(myRTC.dayofmonth);
#include <virtuabotixRTC.h>
// Format the hour to 12-hour format for a classic clock look int displayHour = myRTC.hours; String ampm = "AM";
If you see the error message virtuabotixRTC.h: No such file or directory when compiling, it is a strong indication that the library has not been installed correctly. In this case, simply repeat the steps above to ensure the library is properly added.