Virtuabotixrtc.h Arduino Library !!exclusive!! 〈TOP | Roundup〉
This tiny board usually has 5 pins:
| Library | RTC Chip | Interface | Features | |---------|----------|-----------|----------| | VirtuabotixRTC.h | DS1302 | 3-wire bitbang | Simple, NV RAM | | RTClib (Adafruit) | DS1307, PCF8523, DS3231 | I2C | Leap year, temperature, alarms | | DS1302 (Arduino playground) | DS1302 | 3-wire | Lightweight, no RAM support |
The virtuabotixRTC.h library is a widely-used tool for interfacing Arduino boards with Real-Time Clock (RTC) modules, specifically the chip. This library simplifies the process of reading and setting time, allowing projects like digital clocks, data loggers, and automated systems to maintain accurate time even when power is lost. Key Features and Functionality
// SET THE TIME ONCE, THEN COMMENT THIS LINE OUT OR IT WILL RESET EVERY TIME YOU REBOOT // Format: seconds, minutes, hours, day of week, day of month, month, year // Example: October 24, 2023, 14:30:00, Tuesday (Day of week is 1-7, Mon-Sun) // myRTC.setDS1302Time(00, 30, 14, 2, 24, 10, 23); virtuabotixrtc.h arduino library
The virtuabotixRTC.h library is a fantastic tool for any Arduino enthusiast looking to add timekeeping to their projects. Its simplicity is its greatest strength, providing a clear and effective pathway to get a DS1302-based RTC module running in minutes.
// UNCOMMENT THE NEXT LINE TO SET TIME, THEN COMMENT IT BACK AND RE-UPLOAD // myRTC.setDS1302Time(00, 30, 14, 4, 25, 10, 2023);
While VirtuabotixRTC is great for its simplicity and flexibility with pin selection, RTClib is often the more powerful and robust choice for serious projects, especially when using the highly accurate DS3231 chip. This tiny board usually has 5 pins: |
Most users ignore the 31 bytes of NV RAM on the DS1302. However, VirtuabotixRTC.h exposes this through writeRAM() and readRAM() . This RAM is separate from the time registers and retains data as long as backup power is supplied.
Serial.println("RTC Time has been set!");
This is the most crucial function in the library. Before you can read any time data, you must call myRTC.updateTime() . This command fetches the latest time values from the DS1302 chip and stores them in the myRTC object's variables. You should call this function at the beginning of your loop() or whenever you need a fresh timestamp. Its simplicity is its greatest strength, providing a
Serial.print(myRTC.hours); // Cached values Serial.print(":"); Serial.print(myRTC.minutes); Serial.print(":"); Serial.println(myRTC.seconds);
When the DS1302 loses all power, bit 7 of the seconds register (CH) is set, stopping the oscillator. The library does automatically clear this flag on initialization. If your RTC seems frozen, manually clear it:
