Please know that I created this class for a one-off project before I really knew how to use Git or how to support my code as an open-source contribution. Consequently, other users quite appropriately forked it and you will find more up-to-date (i.e., actually usable) equivalents elsewhere.
My goal in creating yet another DS1307 library was to provide easy access to some of the other functions I needed from the chip, specifically its square wave output and its battery-backed RAM.
@todo Mostly comments in RealTimeClockDS1307.h
-
RealTimeClockDS1307_Test.pdeallow you to turn the clock on/off, set date/time, set 12/24h, [de]activate the square wave, and read/write memory from the Serial Monitor. -
RealTimeClockDS1307.fzis a Fritzing breadboard layout showing the basic hookup of the Sparkfun RTC module to an Arduino. Included is an optional resistor+LED to show the square wave (note that it's an open drain, so you hook up to it rather differently than, say, pin 13).
- Reverse renaming of getDate() and setDate(), now getDay() is calling getDate() and setDay() is calling setDate()
- Readme improvements
- changed getDate() to getDay() and setDate() to setDay()
- updated keywords.txt
- updated example
- added keywords.txt for syntax highlighting
- Updated for Arduino 1.00; testing with Andreas Giemza (hurik)
- added multi-byte read/write
- initial release
- web page documentation
Much thanks to John Waters and Maurice Ribble for their earlier and very helpful work (even if I didn't wind up using any of their code):
- http://combustory.com/wiki/index.php/RTC1307_-_Real_Time_Clock
- http://www.glacialwanderer.com/hobbyrobotics/?p=12
RealTimeClockDS1307 - library to control a DS1307 RTC module Copyright (c) 2011 David H. Brown. All rights reserved
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA